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PREFACE 


This manual describes the resident Operating System (OS) for the 
ATARI® Home Computer* for readers who are familiar with the 
internal behavior of the system. It discusses: 

o System functions and utilization techniques 

o Subsystem relationships and organization 

o Charac ter istics of the ATARI peripheral devices that can 
be attached to the ATAR I400CTM3 and ATARI 800CTM3 Home 
Computer 

o Advanced techniques for going beyond the basic OS 
capab i 1 i t ies 

o The general features of the computer system hardware used 
by the OS. 

It would be helpful to have a familiarity with programming concepts 
and terminology* assembly language programming in general* the 
Synertek 6502 in particular* and digital hardware concepts and 
terminology. you will be provided with the information you need to 
use the OS resources* without resorting to tr ia 1-and-error techniques 
or the OS listing. Supporting information for tasks that involve OS 
listing references is also provided. 

This manual does not present a comprehensive description of the 
hardware used to provide OS capabilites. The programmer who needs to 
go beyond the capabilities described should consult the ATARI Home 
Computer Hardware Manual. 


OPERATING SYSTEM C016555 
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1 INTRODUCTION 


GENERAL DESCRIPTION OF THE ATARI HOME COMPUTER SYSTEM 

Operating systems in the ATARI® 400CTM3 and ATARI 800CTM3 Home 
Computer are identical. The primary differences between the tu/o are 

o Physical packaging 

o The ATARI 400 Computer console has one cartridge slot/ the 
ATARI 800 Computer console has two cartridge slots 

o The ATARI 400 Home Computer contains 16K RAM and cannot be 
expanded. The ATARI 800 Home Computer can be expanded to a 
maximum of 48K RAM. 

o The ATARI 800 Computer has a monitor jack; the ATARI 400 
Computer does not. 

The Hardware Circuitry 

o Produces both character and point graphics for black and 
white (B/W) or color television. 

o Produces four independent audio channels (frequency 
controlled) which use the television sound system. 

o Provides one bi-level audio output in the base unit. 

o Interfaces with up to four Joysticks and eight Paddle 
Control lers. 

o Interfaces with a serial I/O bus for expansion, 
o Contains a built-in keyboard 

Figure 1-1 presents a simplified block diagram of the hardware. 

See the hardware manual for supporting documentation. 
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Figure 1-1. ATARI Home Computer Block Diagram 
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CONVENTIONS USED IN THIS MANUAL 


This manual uses the following special notations: 

Hexadecimal Numbers 

All two-digit numbers preceded by a dollar sign ($) designate 
hexadecimal numbers. All other numbers (except memory addresses) 
are in decimal form unless otherwise specified in the supporting 
text. 

Memory Addresses 

All references to computer memory and mapped I/O locations are in 
hexadecimal notation. Memory addresses may or may not be contained 
in square brackets. (Example: CD20F3 and D20F are the same 
address. ) 

Kilobytes of Memory 

Memory sizes are frequently expressed in units of kilobytes/ such 
as 32K/ where a kilobyte is 1024 bytes of memory. 


PASCAL As an Algorithm-Specification Language 

The PASCAL language (procedure block only) is used as the 
spec if icat ion language in the few places where an algorithm is 
specified in detail. PASCAL syntax is similar to any number of 
other block-structured languages/ and you should have no 
difficulty following the code presented. 


Memory Layouts 

Diagrams similar to Figure 1-2 are used whenever pictures of bytes 
or tables are presented: 


7 6 5 4 3 2 1 0 


+-4—+ , —f“+-+--+""+“+ 

! { This 

i < 

i < 

+ + This 

< < 

i i 

+ -+— 4-~4-~+ b b I b 


is a single byte, 
is a word (2 bytes). 


+ — b — >-“+ — — b — + 


This is a block of memory 
of unspecified length. 


Figure 1-2. Memory Layout Chart 
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Bit 7 is the most significant bit (MSB) of the byte/ and Bit O 
is the least significant bit (LSB). 

In tables and figures/ memory addresses always increase toward the 
bottom of the figure. 


Backus-Naur Form 

A modified version of Backus-Naur Form (BNF) is used to express some 
syntactic forms# where the following metalinguistic symbols are used: 

: = is the substitution (assignment) operator. 

< > a metasyntac t ic variable. 

i separates alternative substitutions. 

C 3 an optional construct. 

Anything else is a syntactic literal constant# which stands for 
itself. 

For Example: 

<device spec if ication> : : = -Cdevice name>C<device number>3: 

<device name> : : = C IDiEiKiPJRSS 
<device number> ::= 1 1 2 ! 3 « 4 « 5 ! 6 ! 7 1 8 


A “device spec if icat ion“ consists of a mandatory “device name#" 
followed by an optional “device number#" followed by the mandatory 
colon character. The device name in turn must be one of the 
characters shown as alternat i ves. The device number (if it is present) 
must be a digit 1 through 8. 


OS Equate Filenames 

Operating System ROM (Read Only Memory) and RAM (Random Access 
Memory) vector names# RAM database variable names and hardware 
register names are all referred to by the names assigned in the OS 
program equate list. When one of these names is used# the memory 
address is usually provided# such as BOOTAD C02423. 
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2 OPERATING SYSTEM FUNCTIONAL ORGANIZATION 


This section describes the various subsystems of the resident OS in 
general terms. 

Input/Output Subsystem 

The Input/Output (I/O) subsystem provides a high-level interface 
between the programs and the hardware. Most functions are 
device-independent/ such as the reading and writing of character data; 
yet provisions have been made for device-dependent functions as well. 
All peripheral devices capable of dealing with character data have 
individual symbolic names (such as K# D# P/ etc), and can be accessed 
using a Central I/O (CIO) routine. 

A RAM data base provides access to controllers (joysticks and paddle 
controllers), which do not deal with character data. This RAM data 
base is periodically updated to show the states of these devices. 


INTERRUPT PROCESSING 

The interrupt system handles all hardware interrupts in a common 
and consistent manner. By default# all interrupts are fielded by 
the OS. At your discretion# individual interrupts (or 
groups of interrupts) can be fielded by the application program. 


INITIALIZATION 

The system provides two levels of ini tial i zation: power up and 
system reset. The OS performs power-up ini t ial i zat ion each time 
the system power is switched to ON# and system reset 
init ial i zat ion is performed each time the CSYSTEM. RESET! key is 
pressed . 


Power-Up 

The OS examines and notes the conf iguration of the unit whenever 
the system power is switched to ON. The system performs the following 
tasks at power up: 
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o 


Determines the highest RAM address. 
Clears all of RAM to zeros. 


o 

o Establishes all RAM interrupt vectors, 

o Formats the device table, 

o Initializes the car tridge ( s > . 

o Sets up the screen for 24 x 40 text mode, 
o Boots the cassette if directed. 

o Checks cartridge slot<s) for diskette-boot instructions. 

o Boots the diskette if directed to do so and a disk drive unit 
is attached. 

o Transfers control to the cartridge# diskette-booted program# 
cassette-booted program# or blackboard program. 

C SYSTEM. RESET 3 

Pressing the C SYSTEM. RESET 3 key causes the OS to perform these 
following tasks: 

o Clears the OS portion of RAM. 
o Rechecks top of RAM. 

o Reestablishes all RAM interrupt vectors, 
o Formats the device table, 
o Initializes the car tr idge < s > . 
o Sets up the screen for 24 x 40 text mode. 

o Transfers control to the cartridge# a diskette-booted program# 
a cassette-booted program# or the blackboard program. 

Note that C SYSTEM. RESET! does not perform all the power— up 
tasks listed in the power-up section. 
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FLOATING POINT ARITHMETIC PACKAGE 

The OS ROM contains a Floating Point (FP) package that is available 
to nonresident programs such as ATARI BASIC. 

The package is not used by the other parts of the OS itself. The 
floating point numbers are stored as 10 BCD digits of mantissa* plus a 
l~byte exponent. The package contains these routines: 

o ASCII-to-FP and FP-to-ASCII conversion. 

o Integer-to-FP and FP-to-integer conversion. 

o FP add* subtract, multiply and divide. 

o FP log, exp, and polynomial evaluation. 

o FP number clear, load, store, and move. 
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You set these 2-bytes. They contain information that is 
used by the OPEN command process and/or is device-dependent. 

For OPEN/ two bits of ICAX1 are always used to specify the OPEN 
direction as shown below# where R is set to 1 for input (read) 
enable and W is set to 1 for output (write) enable. 


7 3 2 0 

h-+-+-+--»--+ 

i i i < i W i n i i i 

+— +— + — h — h — H- + -4--+ 

ICAX1 is not altered by CIO. You should not alter ICAX1 
once the device/file is open. 

The remaining bits of ICAX1 and all of ICAX2 contain only 
device-dependent data and are explained later in this section. 


Remaining Bytes ( ICAX3-ICAX6) 

The handler reserves the four remaining bytes for processing the 
I/O command for CIO. There is no fixed use for these bytes. They 
are not user-al terab le except as specified by the particular 
device descriptions. These bytes will be referred to as ICAX3# 
ICAX4# ICAX5 and ICAX6, although there are no equates for those 
names in the OS equate file. 


CIO Functions 

The CIO supports records and blocks and the handlers support 
single bytes. All of the system handlers support one or more 
of the eight basic functions subject to restrictions based 
upon the direction of data transfer (e.g. one cannot read data 
from the printer). The basic functions are: OPEN# CLOSE# GET 
CHARACTERS, PUT CHARACTERS# GET RECORD, PUT RECORD, GET STATUS# 
and SPECIAL. 


OPEN — Assign Device/Fi lename to IOCB and Ready for Access 

A device/file must be opened before it can be accessed. This 
process links a specific IOCB to the appropriate device 
handler# initializes the device/file# initializes all CIO 
control variables, and passes device-spec if ic options to the 
device handler. 
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You set up the following IOCB parameters prior to calling CIO for an 
OPEN operation: 

COMMAND BYTE = *03 

BUFFER ADDRESS » pointer to a device/filename spec if ication. 

AUX1 = OPEN direction bits/ plus device-dependent information. 

AUX2 = device-dependent information. 

After an OPEN operation/ CIO will have altered the following IOCB 
parameters : 

HANDLER ID = index to the system device table; this is 
used only by CIO and must not be altered. 

DEVICE NUMBER = device number taken from the device/filename 
specification and must not be altered. 

STATUS = result of OPEN operation; see Appendix B for a list 
of the possible status codes. In general/ a negative status 
will indicate a failure to open properly. 

PUT ADDRESS = pointer to the PUT CHARACTERS routine for the 
device handler just opened. 

It is recommended that this pointer not be used. 


CLOSE — Terminate Access to Device/File and Release IOCB. 

You issue a CLOSE command after you are through accessing a 
given device/file. The CLOSE process completes any pending data 
writes/ goes to the device handler for any device-spec if ic 
actions/ and then releases the IOCB. 

You set the following IOCB parameter prior to calling 
CIO: 

COMMAND BYTE * *0C 

The CIO alters the following IOCB parameters as a result of the 
CLOSE operation: 

HANDLER ID = *FF 

STATUS = Result of CLOSE operation. 

PUT ADDRESS * pointer to “IOCB not OPEN" routine. 
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GET CHARACTERS — Read n Characters (By te-Al igned Access) 

The specified number of characters are read from the device/file 
to the user-supplied buffer. EOL characters have no termination 
features when using this function/ there can be no EOL/ or many 
EOL'S/ in the buffer after operation completion. There is a 
special case provided that passes a single byte of data in the 
6502 A register when the buffer length is set to zero. 

You set the following IOCB parameters prior to calling CIO: 

COMMAND BYTE » $07 

BUFFER ADDRESS * pointer to data buffer. 

BUFFER LENGTH = number of bytes to read; if this is zero/ 
the data will be returned in the 6502 A register only. 

The CIO alters the following IOCB parameters as a result of the 
GET CHARACTERS operation: 

STATUS * result of GET CHARACTERS operation. 

BYTE COUNT/BUFFER LENGTH = number of bytes read to the 
buffer. The BYTE COUNT will always equal the BUFFER LENGTH 
except when an error or an end-of-file condition occurs. 


PUT CHARACTERS — Write n Characters (Byte-Aligned Access) 

The specified number of characters are written from the user-supplied 
buffer to the device/file. EOL characters have no buffer 
terminating properties/ although they have their standard meaning 
to the device/file receiving them; no EOL's are generated by CIO. 
There is a special case that allows a single character to be 
passed to CIO in the 6502 A register if the buffer length is 
zero. 

You set the following IOCB parameters prior to initiating the PUT 
CHARACTERS operation: 

COMMAND BYTE » *0B 

BUFFER ADDRESS = pointer to data buffer. 

BUFFER LENGTH = number of bytes of data in buffer. 

The CIO alters the following IOCB parameter as a result of the 
PUT CHARACTERS operation: 

STATUS * result of PUT CHARACTERS operation. 
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GET RECORD — Read Up To n Characters (Record-Al igned Access) 


Characters are read from the device/file to the user-supp 1 ied 
buffer until either the buffer is full or an EOL character is 
read and put into the buffer. If the buffer fills before an EOL 
is read/ then the CIO continues reading characters from the 
device/file until an EOL is read// and sets the status to 
indicate that a truncated record was read. No EOL will be put at 
the end of the buffer. 

You set the following IOCB parameters prior to calling CIO: 
COMMAND BYTE = *05 

BUFFER ADDRESS = pointer to data buffer. 

BUFFER LENGTH = maximum number of bytes to read (including 
the EOL character). 

The CIO alters the following IOCB parameters as a result of the 
GET RECORD operation: 

STATUS = result of GET RECORD operation. 

BYTE COUNT/BUFFER LENGTH = number of bytes read to data 
buffer; this can be less than the maximum buffer length. 


PUT RECORD — Write Up To n Characters (Record-Aligned Access) 


Characters are written from the user-supplied buffer to the 
device/file until either the buffer is empty or an EOL character 
is written. If the buffer is emptied without writing an EOL 
character to the device/file/ then CIO will send an EOL after the 
last user-supp 1 ied character. 

You set the following IOCB parameters prior to calling CIO: 
COMMAND BYTE = *09 

BUFFER ADDRESS = pointer to data buffer. 

BUFFER LENGTH = maximum number of bytes in buffer. 

The CIO alters the following IOCB parameter as a result of the 
PUT RECORD operation: 

STATUS * result of PUT RECORD operation. 
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QET STATUS — Return Device-Dependent Status Bytes 

The device controller is sent a STATUS command# and the 
controller returns four bytes of status information that are 
stored in DVSTAT C02EA3. 

You set the following IOCE parameters prior to calling CIO: 
COMMAND BYTE = $OD 


BUFFER ADDRESS = pointer to a device/filename specification 
if the IOCB is not already OPEN# see the discussion of the 
implied OPEN option below. 


After a GET 
parameters : 

STATUS 
a list 


STATUS operation# CIO will have altered the following 

• result of GET STATUS operation# see Appendix B for 
of the possible status codes. 


DVSTAT = the four-byte response from the device controller. 


SPECIAL — Special Function 

Any command byte value greater than SOD is treated by CIO as a 
special case. Since CIO does not know what the function is# CIO 
transfers control to the device handler for complete processing 
of the operation. 

The user sets the following IOCB parameters prior to 
calling CIO: 

COMMAND BYTE > SOD 

BUFFER ADDRESS = pointer to a device/filename specification 
if the IOCB is not already open# see the discussion of the 
implied OPEN option below. 

Other IOCB bytes can be set up# depending upon the specific 
SPECIAL command being performed. 

After a SPECIAL operation# CIO will have altered the following 
parame ters : 

STATUS * result of SPECIAL operation# see Appendix B for a 
list of the possible status codes. 

Other bytes can be altered# depending upon the specific 
SPECIAL command. 
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Implied OPEN Option 


The GET STATUS and SPECIAL commands are treated specially by CIO* 
they can use an already open IOCB to initiate the process or they 
can use an unopened IOCB. If the IOCB is unopened* then the 
buffer address must contain a pointer to a device/f i lename 
spec if icat ion* just as for the OPEN command* CIO will then open 
that IOCB* perform the specified command and then close the IOCB 
again. 


Device/Fi lename Specif ication 

As part of the OPEN command* the IOCB buffer address parameter 
points to a device/filename spec if icat ion* that is a string of 
ATASCII characters in the following format: 

<spec if icat ion> : : = Cdevi ce>C<number>3 : CCf i lename>3<eol> 

<device> C S D IE { K ! P { R ! S 

<number> ::= 1I2!3I4I5!6!7!8 

<filename> has device-dependent character ist ics. 

<eol> : : = *9B 

The following devices are supported at this writing: 

C = Cassette drive 

Di through D8 = Floppy diskette drives * 

E = Screen Editor 
K = Keyboard 
P * 40-column printer 
P2 = 80— column printer * 

R1 through R4 = RS-232-C interfaces * 

S = Screen display 

Devices flagged by asterisks <*> are supported by nonresident 
handlers. 

If <number> is not specified* it is assumed to be 1. 

The following examples show valid device/f i lename specifications: 
C: Cassette 

D2.BDAT File “BDAT** on disk drive #2 

D: HOLD File “HOLD" on disk drive #1 

K: Keyboard 
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I/O Example 

The example provided in this section illustrates a simple example of 
an I/O operation using the CIO routine. 


; This code segment illustrates the simple example of reading 
i text lines (records) from a diskette file named TESTER on disk 
> drive #i. All symbols used are equated within the program 
; although many of the symbols are in the OS equate file. 

i The program performs the following steps: 

i 

} 1. Opens the file 'Dl: TESTER' using IOCB #3. 


i 2. Reads records until an 

i 3. Closes the file. 

; I/O EQUATES 


E0L= 

♦9B 

I0CB3* 

♦30 

ICHID* 

♦0340 

ICDNQ* 

ICHID+1 

ICCOM* 

ICDNO+1 

ICSTA* 

ICCOM+1 

ICBAL* 

ICSTA+1 

ICBAH= 

ICBAL+1 

ICPTL* 

ICBAH+1 

ICPTH* 

ICPTL+1 

ICBLL* 

ICPTH+1 

ICBLH* 

ICBLL+1 

ICAX1* 

ICBLH+1 

ICAX2= 

ICAX1+1 

OPEN* 

♦03 

GETREC* 

♦05 

CLOSE* 

♦OC 

OREAD* 

♦04 

OWRIT* 

♦08 

EOF* 

♦88 

CIOV* 

♦E456 


error or EOF is reached. 


i END OF LINE CHARACTER. 
i IOCB #3 OFFSET (FROM IOCB #0). 

; (HANDLER ID — SET BY CIO), 
i (DEVICE # — SET BY CIO). 

• COMMAND BYTE. 

; STATUS BYTE — SET BY CIO. 

/ BUFFER ADDRESS (LOW). 

,* BUFFER ADDRESS (HIGH). 


i BUFFER LENGTH (LOW). 

; BUFFER LENGTH (HIGH). 

; AUX 1. 

> AUX 2. 

; OPEN COMMAND. 

; GET RECORD COMMAND. 

; CLOSE COMMAND. 

; OPEN DIRECTION = READ, 
i OPEN DIRECTION * WRITE. 

; END OF FILE STATUS VALUE. 

; CIO ENTRY VECTOR ADDRESS. 


FIRST INITIALIZE THE IOCB FOR FILE “OPEN". 


LDX # I0CB3 / SETUP TO ACCESS IOCB #3. 
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LDA 

STA 

#OPEN 

ICCOM, X 

; SETUP 

OPEN COMMAND. 

LDA 

STA 

LDA 

STA 

#NAME 

ICBAL/ X 
#NAME/256 
ICBAHi X 

; SETUP BUFFER POINTER TO 
; ... POINT TO FILENAME. 

LDA 

STA 

#OREAD 

ICAX1, X 

; SETUP 

FOR OPEN READ. 

LDA 

STA 

#0 

ICAX2, X 

; CLEAR 

AUX 2. 


; "OPEN" THE FILE. 


JSR CIOV 

BPL TP 10 

JMP ERROR 


; SETUP TO READ A RECORD. 


LDA 

#GETREC 

; SETUP 

"GET RECORD" 

COMMAND 

STA 

ICCOM, X 




LDA 

#BUFF 

; SETUP 

DATA BUFFER 

POINTER. 

STA 

ICBAL/ X 




LDA 

#BUFF/256 




STA 

ICBAH, X 





9 

; READ RECORDS. 


LOOP LDA #BUFFSZ 

STA ICBLL* X 

LDA #BUFFSZ/256 

STA ICBLH, X 

JSR CIOV 

BMI TP20 


9 

; A RECORD IS NOW IN THE DATA BUFFER "BUFF". IT IS TERMINATED BY 
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; SETUP MAX RECORD SIZE 
; ... PRIOR TO EVERY READ. 


i READ A RECORD. 

; MAY BE END OF FILE. 


i PERFORM "OPEN" OPERATION. 

; STATUS WAS POSITIVE — OK. 

; NO — "OPEN" PROBLEM. 



AN EOL CHARACTER# AND THE RECORD LENGTH IS IN “ ICBLL" and ,, ICBLH H 
THIS EXAMPLE WILL DO NOTHING WITH THE RECORD JUST READ. 


JMP LOOP # READ NEXT RECORD. 


NEGATIVE STATUS ON READ — CHECK FOR END OF FILE. 


CPY 

#EOF 

# END 

OF FILE STATUS? 

BNE 

ERROR 

# NO - 

— ERROR. 

LDA 

#CLOSE 

; YES 

— CLOSE FILE. 

STA 

ICCOM, X 



JSR 

CIOV 

# CLOSE THE FILE. 

JMP 

■* 

i *•** 

END OF PROGRAM *** 


DATA REGION OF EXAMPLE PROGRAM 


NAME . BYTE "D1 : TESTER"# EOL 

BUFFSZ* 80 # 80 CHARACTER RECORD MAX 

(INCLUDES EOL) 

BUFF= * i READ BUFFER. 

*= *+BUFFSZ 

. END 

Figure 5-3 An I/O Example 
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Device-Specific Information 


This section provides device-specific information regarding the 
device handlers that interface to CIO. 


Keyboard Handler (K: ) 

The keyboard device is a read only device with a handler that 
supports the following CIO functions: 


OPEN 

CLOSE 

GET CHARACTERS 
GET RECORD 

GET STATUS (null function) 


The Keyboard Handler can produce the following error statuses: 


$80 — t BREAK 3 key abort. 

$88 — end-of-file (produced by pressing CCTRL3 3). 


The Keyboard Handler is one of the resident handlers. It has a 
set of device vectors starting at location E420. 

The keyboard can produce any of the 25 6 codes in the ATASCII 
character set (see Appendix F). Note that a few of the keyboard 
keys do not generate data at the Keyboard Handler level. These 
keys are described below: 

C/«\3 - The ATARI key toggles a flag that enab ies/d i sab 1 es th 
inversion of bit 7 of each data character read. The 
Screen Editor editing keys are exempted from such 
inversion/ however. 

CAPS - The CCAPS/L0WR3 key provides three functions: 

C SH I FT 3 C C APS/LOWR 3 — Alpha caps lock. 
CCNTRL3CCAPS/L0WR 3 — Alpha CCTRL3 lock. 
CCAPS/LOWR 3 — Alpha unlock. 
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The system powers up and will system reset to the alpha 
caps lock option. 

Some key combinations are ignored by the handler# such as 
CCTRL3 4 through CCTRL3 9# CCTRL3 0# CCTRL3 1# CCTRL3 /# and 
all key combinations in that the CSHIFT3 and CCTRL3 keys are 
depressed simultaneously. 

The CCTRL3 3 key generates an EQL character and returns EOF status. 
The CBREAK3 key generates an EOL character and returns BREAK status. 


CIO Function Descriptions 

The device-specific charac ter ist ics of the standard CIO functions 
(described earlier in this section) are detailed below: 

OPEN 

The device name is K# and the handler ignores any device number 
and filename specification# if included. 

There are no device-dependent option bits in AUX1 or AUX2. 


CLOSE 

No special handler actions. 


GET CHARACTERS and GET RECORD 

The handler returns the ATASCII key codes to CIO as they are 
entered# with no facility for editing. 


GET STATUS 

The handler does nothing but set the status to $01. 


Theory of Operation 

Pressing a keyboard key generates an IRQ interrupt and vectors to 
the Keyboard Handler's interrupt service routine (see Section 6). 
The key code for the key pressed is then read and stored in data 
base variable CH C02FC3. This occurs whether or not there is an 
active read request to the Keyboard Handler# and effects a one-byte 
FIFO for keyboard entry. See Appendix L (E8) for a discussion of 
the auto repeat feature. 
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The Keyboard Handler monitors the CH variable for not containing 
the value $FF (empty state) whenever there is an active read 
request for the handler. When CH shows nonempty# the handler 
takes the key code from CH and sets CH to $FF again. The key code 
byte obtained from CH is not an ATASCII code and has the 
following form: 


■+•-+ — h-4- — h-4--+ — ^ 

‘CIS I key code I 


Where: C = i if the CCTRL3 key is pressed. 

S = 1 if the CSHIFT3 key is pressed. 

The remaining six bits are the hardware key code. 


The key code obtained is then converted to ATASCII using the 
first of the following rules that applies: 

1. Ignore the code if the C and S bits are both set. 

2. If the C bit is set# process the key as a CCTRL3 code. 

3. If the S bit is set# process the key as a CSHIFT3 code. 

4. If CCTRL3 lock is in effect# process alpha characters as CTRL 

codes# all others as lowercase. 

5. IF CSHIFT3 lock is in effect# process alpha characters as SHIFT 
codes# all others as lowercase. 

6 . Else# process as lowercase character. 

Then: If the resultant code is not a Screen Editor control code# 
and if the video inverse flag is set# then set bit 7 of the 
ATASCII code (will cause inverse video when displayed). 
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KEY CODE TO ATASCII CONVERSION TABLE 


Key 

Code 

Key 

Cap 

Lwr . 
Case 

C SHI FT 3 

CCTRL3 

Key 

Code 

Key 

Cap 

Lwr . 
Case 

SHIFT 

CTRL 

00 

L 

6C 

4C 

OC 

20 

» 

2C 

5B 

00 

01 

J 

6A 

4A 

OA 

21 

SPACE 

20 

20 

20 

02 

/ 

3B 

3A 

7B 

22 

. 

2E 

5D 

60 

03 

— 

— 

— 

— 

23 

N 

6E 

4E 

OE 

04 

— 

— 

— 

— 

24 

— 

— 

— 

— 

05 

K 

6B 

4B 

OB 

25 

M 

6D 

4D 

OD 

06 

4- 

2B 

5C 

IE 

26 

/ 

2F 

3F 

— 

07 


2A 

5E 

IF 

27 

/ ♦ \ 

— 

— 

— 

08 

0 

6F 

4F 

OF 

28 

R 

72 

52 

12 

09 

— 

— 

— 

— 

29 

— 

— 

— 

— 

OA 

p 

70 

50 

10 

2A 

E 

65 

45 

05 

OB 

u 

75 

55 

15 

2B 

Y 

79 

59 

19 

OC 

RET 

9B 

9B 

9B 

2C 

TAB 

7F 

9F 

9E 

OD 

I 

69 

49 

09 

2D 

T 

74 

54 

14 

OE 

- 

2D 

5F 

1C 

2E 

W 

77 

57 

17 

OF 

= 

3D 

7C 

ID 

2 F 

G 

71 

51 

11 

10 

V 

76 

56 

16 

30 

9 

39 

28 

— 

11 

— 

— 

— 

— 

31 

— 

— 

— 

— 

12 

c 

63 

43 

03 

32 

0 

30 

29 

— 

13 

— 

— 

— 

— 

33 

7 

37 

27 

— 

14 

— 

— 

— 

— 

34 

BACKS 

7E 

9C 

FE 

15 

B 

62 

42 

02 

35 

8 

38 

40 

— 

16 

X 

78 

58 

18 

36 

,r 

3C 

7D 

7D 

17 

Z 

7A 

5A 

1A 

37 

> 

3E 

9D 

FF 

18 

4 

34 

24 

— 

38 

F 

66 

46 

06 

19 

— 

— 

— 

— 

39 

H 

68 

48 

08 

1A 

3 

33 

23 

9B* 

3A 

D 

64 

44 

04 

IB 

6 

36 

26 

— 

3B 

— 

— 

— 

— 

1C 

CESC1 

IB 

IB 

IB 

3C 

CAPS 

— 

— 

— 

ID 

5 

35 

25 

— 

3D 

G 

67 

47 

07 

IE 

2 

32 

22 

FD 

3E 

S 

73 

53 

13 

IF 

1 

31 

21 

— 

3F 

A 

61 

41 

01 


* CCTRL3 3 returns EOF status. 

A complement of this table (ATASCII to keystroke) is given in 
Appendix F. 

Figure 5-4 Keycode to ATASCII Conversion Table 


OPERATING SYSTEM C016555 


Section 5 



Display Handler (S: ) 


The display device is a read/write device with a handler 
that supports the following CIO functions: 


OPEN 

CLOSE 

GET CHARACTERS 
GET RECORD 
PUT CHARACTERS 
PUT RECORD 

GET STATUS (null function) 

DRAW 

FILL 


The Display Handler can produce the following error statuses: 

$84 — Invalid special command. 

$8D — Cursor out-of -range. 

$91 — Screen mode > 11. 

$93 — Not enough memory for screen mode selected. 

The Display Handler is one of the resident handlers* and 
therefore has a set of device vectors starting at location E410. 


Screen Modes 

You can operate the display screen in any of 20 
configurations (modes 1 through 8* with or without split 
screen* plus mode 0* and modes 9 through 11 without split 
screen). Mode 0 is the text displaying mode. Modes 1 through 
11 are all graphics modes (although modes 2 and 3 do display a 
subset of the ATASCII character set). Modes 9 through 11 
require a GTI A chip to be installed in place of the standard 
CTI A chip. 


TEXT MODE 0 

In text mode 0 the screen is comprised of 24 lines of 40 
characters per line. Program alterable left and right margins 
limit the display area. They default to 2 and 39 (of a possible 
and 39). 
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A program-controllable cursor shows the destination of the next 
character to be output onto the screen. The cursor is visible as 
the inverse video representat ion of the current character at the 
destination position. 

The text screen data is internally organized as variable length 
logical lines. The internal representation is 24 lines when the 
screen is cleared. Each EOL marks the end of a logical line as 
text is sent to the screen. If more than 3 physical lines of text 
are sent/ a logical line will be formed every 3 physical lines. 
The number of physical lines used to comprise a logical line (1 
to 3) is always the minimum required to hold the data for that 
logical line. 

The text screen "scrolls" upward whenever a text line at the 
bottom row of the screen extends past the right margin/ or a text 
line at the bottom row is terminated by an EOL. Scrolling removes 
the entire logical line that starts at the top of the screen/ and 
then moves all subsequent lines upward to fill in the void. The 
cursor also moves upward/ if the logical line deleted exceeds one 
physical line. 

All data going to or coming from the text screen is represented 
in 8-bit ATASCII code as shown in Appendix E. 


TEXT MODES 1 AND 2 

In text modes 1 and 2 the screen comprises either 24 lines of 20 
characters (mode 1)/ or 12 lines of 20 characters (mode 2). The 
left and right margins are of no consequence in these modes and 
there is no visible cursor. There are no logical lines associated 
with the data and in all regards these modes are treated as 
graphics modes by the handler. 

Data going to or coming from the screen is in the form shown 
below: 


7 0 

+-+-+- 4 --+-+—+ — — ► 

{ C { D \ 

Where:C is the color/charac ter-set select field 
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c 

Value 

Color 

(default) 

Col or 

Register 

(see 

Append i x 
H) 

Character 

Set 

CHBAS=*EO 

Charac ter 

Set 

CHBAS=*E2 

0 

green 

(PF1) 

< _ 

? 

t HEART 3 C ARROW 3 

1 

gold 

(PFO) 

i _ 

? 

E HEART 3 E ARROW 3 

2 

gold 

(PFO) 

@ - 


E D I AMOND 3 C TR I ANGLE 3 

3 

green 

(PF1) 

@ - 


E D I AMOND 3 E TR I ANGLE 3 

4 

red 

(PF3) 

i — 

? 

E HEART 3 E ARROW 3 

5 

blue 

(PF2) 

1 _ 

? 

E HEART 3 EARRQW3 

6 

blue 

(PF2) 

@ - 


E D I AMOND 3 E TR I ANGLE 3 

7 

red 

(PF3) 

e - 


C D I AMOND 3 C TR I ANGLE 3 


D is a 5-bit truncated ATASCII code that selects the specific 
character within the set selected by the C field. See Appendix E 
for the graphics representations of the characters. 

Data base variable CHBAS CQ2F43 allows for the selection of 
either of two data sets. The default value of $EO provides the 
capital letters# numbers and punctuation characters# the 
alternate value of $E2 provides lowercase letters and the special 
character graphics set. 


Figure 5-5 Text Modes 1 and 2 Data Form 


GRAPHICS MODES (Modes 3 Through 11) 

The screen has varying physical character istics for each of the 
graphics modes as shown in Appendix H. Depending upon the mode# a 
1 to 16 color selection is available for each pixel and the 
screen size varies from 20 by 12 (lowest resolution) to 320 by 
192 (highest resolution) pixels. 

There is no visible cursor for the graphics mode output. 

Data going to or coming from the graphics screen is represented 
as 1 to 8-bit codes as shown in Appendix H and in the GET/PUT 
diagrams following. 


SPLIT-SCREEN CONFIGURATIONS 

In split-screen configurations# the bottom of the screen is 
reserved for four lines of mode 0 text. The text region is 
controlled by the Screen Editor# and the graphics region is 
controlled by the Display handler. Two cursors are maintained in 
this configuration so that the screen segments can be managed 
independently. 
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To operate in split-screen mode# the Screen Editor must first be 
opened and then the Display Handler must be opened using a 
separate IOCB (with the split-screen option bit set in AUX1). 


CIO Function Descriptions 

The device-spec if ic charac ter ist ics of the standard CIO functions 
(described earlier in this section) are detailed below: 


OPEN 

The device name is S# and the handler ignores any device number an< 
filename spec if icat ion* if included. 


The handler supports the following options: 

7 0 

AUX 1 « i C « S ' W ! R ! i 

Where: C = 1 indicates to inhibit screen clear on OPEN. 

S = 1 indicates to set up a split-screen conf iguration (for 
modes 1 through 8 only). 

R and W are the direction bits (read and write). 

7 0 

+-+—+-+ — *-—+-+ — h-4- 

AUX2 ; : mode i 

+—+~+— +— 4 —+ 

Where: mode is the screen mode (0 through 11). 

Note: If the screen mode selected is 0/ then the AUX1 C and 
S options are assumed to be 0. 

You share memory utilization with the Display Handler 
information. Sharing is necessary because the Display Handler 
dynamically allocates high address memory for use in generating 
the screen display# and because different amounts of memory are 
needed for the different screen modes. Prior to initiating an 
OPEN command the variable APPMHI C000E3 should contain the 
highest address of RAM you need. The Screen handler 
will open the screen only if no RAM is needed at or below that 
address. 

Upon return from a screen OPEN# the variable MEMTOP C02E53 will 
contain the address of the last free byte at the end of RAM 
memory prior to the screen-required memory. 
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As a result of every OPEN command/ the following screen variables 
are altered: 

The text cursor is enabled (CRSINH = 0). The tabs are set to 
the default settings (2 and 39). The color registers are set 
to the default values (shown in Appendix H>. 

Tabs are set at positions 7/15/23/31/39/ 

47/ 55/ 63/ 71, 79, 87, 95, 103, 111, 119. 


CLOSE 

No special handler actions. 


GET CHARACTERS and GET RECORD 

Returns data in the following screen mode dependent forms, where 
each byte contains the data for one cursor position (pixel); there 
is no facility for having the handler return packed graphics data. 


7 0 

! ATASC I I I 

+“+ h~+~+ — b — + — +~+ 

+ 

! C J D 
+ + — | ^ 


4- -4- — 1--+ — H-+--+ — h-4 

I zero ! D ! 

4 * ~ 4 - ~ 4 - — 4 * — + — — 4 - — 4 * — 4 - 

+— 4 > ~4 , —4 — h — 4 — I h — h 

! zero i D ? 

+-+“+“+”+“4"+“4“4 

+—•+— 4 , ~+~+—+— +— 4"“ '4 

! zero i D J 

4.-4. 

Figure 5-6 Graphics Mode 3-11 


Mode 0 

Modes 1,2 — C = color/data 

set. 

D = truncated ATASCII. 

Modes 3,5,7 — D = color. 

Modes 4,6,8 — D = color. 

Modes 9, 10, 11 — D = data. 

Data Form 


The cursor moves to the next position as each data byte is 
returned. For mode O, the cursor will stay within the specified 
margins; for all other modes, the cursor ignores the margins. 
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PUT CHARACTERS and PUT RECORD 

The handler accepts display data 
dependent forms; there is no faci 
graphics data in packed form. 


7 O 

! ATASCII ! 
+“+- , +- , +—+’-+"'+“+“+ 

! C ! D ' 

+ — + — +- - + — + — + “ + — + — • + 


j ? ! d : 

5 ? < D ! 

{ ? ! D I 


n the following screen mode 
ity for the handler to receive 

Mode 0 

Modes 1*2 — C * color/data 

set* 

D = truncated ATASCII. 

Modes 3*5*7 — D = color. 

Modes 4*6*8 — D = color. 

Modes 9* 10* 11 — D = data. 


Figure 5-7 Graphics Mode 3-11 PUT Data Form 


NOTE: For ail modes* if the output data byte equals $9B (EOL)* that 
byte will be treated as an EOL character* and if the output 
data byte equals $7D (CLEAR) that byte will be treated as a 
screen-clear character. 

The cursor moves to the next cursor position as each data byte is 
written. For mode O* the cursor will stay within the specified 
margins* for all other modes* the cursor ignores the margins. 

While outputting* the Display Handler monitors the keyboard to 
detect the pressing of the CCTRL3 1 key combination. When this 
occurs* the handler loops internally until that key combination 
is pressed again: This effects a stop/start function that 
freezes the screen display. Note that there is no ATASCII code 
associated with either the CCTRL3 1 key combination or the 
start/stop function. The stop/start function can be controlled 
only from the keyboard (or by altering database variable CH as 
discussed in Appendix L* E4). 
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GET STATUS 


No handler action except to set the status to $01. 


DRAW 

This special command draws a simulated '‘straight* 1 line from the 
current cursor position to the location specified in ROWCRS 
C00543 and COLORS C00553. The color of the line is taken from the 
last character processed by the Display Handler or Screen Editor. 
To force the color# store the desired value in ATACHR C02FB3. At 
the completion of the command# the cursor will be at the location 
specified by ROWCRS and COLORS. 

The value for the command byte for DRAW is $11. 


FILL 

This special command fills an area of the screen defined by two 

lines with a specified color. The command is set up the same as 

in DRAW# but as each point of the line is drawn# the routine 

scans to the right performing the procedure shown below (in 

PASCAL notation): 

WHILE PIXEL CROW, C0L3 = O DO 
BEGIN 

PIXEL CROW, COL3 : = FILDAT# 

COL : = COL + 1# 

IF COL > Screen right edge THEN COL : = 0 
END; 

An example of a FILL operation is shown below: 


+ 


4 * 


+ 


4 — 

4 + 



4 * 

+ 2 


1 


Where: represents the fill operation. 

/+/ are the line points# with '+' for the endpoints. 

1 — set cursor and plot point. 

2 — set cursor and DRAW line. 

3 — set cursor and plot point. 

4 — set fill data value# set cursor# and FILL. 
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FILDAT C02FD3 contains the fill data, and ROWCRS and COLORS 
contain the cursor coordinates of the line endpoint. The value 
in ATACHR C02FB3 will be used to draw the line; ATACHR always 
contains the last data read or written, so if the steps above 
are followed exactly, ATACHR will not have to be modified. 

The value for the command byte for FILL is $12. 


User-Alterable Data Base Variables 

Certain functions of the Display Handler require you to 
examine and/or alter variables in the OS database. The following 
describes some of the more commonly used handler variables, (see 
Appendix L, Bl-55, for additional descriptions). 


Cursor Position 

Two variables maintain the cursor position for the graphics 
screen or mode 0 text screen. ROWCRS C00543 maintains the display 
row number; and COLCRS C00553 maintains the display column 
number. Both numbers range from 0 to the maximum number of 
rows/columns, - 1. The cursor can be set outside of the defined 
text margins with no ill effect. You can read and write this 
region. The home position (0,0) for both text and graphics is the 
upper left corner of the screen. 

ROWCRS is a single byte. COLCRS is maintained at 2-bytes, with 
the least significant byte being at the lower address. 

When you alter these variables, the screen representation 
of the cursor will not move until the next I/O operation 
involving the display is performed. 


Inhibit/Enable Visible Cursor Display 

You can inhibit the display of the text cursor on the screen 
by setting the variable CRSINH C02F03 to any nonzero value. 
Subsequent I/O will not generate a visible cursor. 

You can enable the display of the text cursor by setting 
CRSINH to zero. Subsequent I/O will then generate a visible 
cursor. 


Text Margins 

The text screen has user-a 1 t erab 1 e left and right margins. The OS 
sets these margins to 2 and 39. The variable LMARGN C00523 
defines the left margin, and the variable RMARGN C00533 defines 
the right margin. The leftmost margin value is O and the 
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rightmost margin value is 39. 


The margin values inclusively define the useable portion of the 
screen for all operations in that you do not explicitly 
alter the cursor location variables as described prior to this 
paragraph. 


Color Control 

The OS updates hardware color registers using data from the OS 
data base as part of normal Stage 2 VBLANK processing (see Section 
6). Shown below are the data base variable names# the hardware 
register names# and the function of each register. See Appendix H 
for the mode dependent uses for the registers. 


Data Base 

Hardware 

Function 

COLORO 

COLPFO 

PFO 

— Playfield 0. 

COLOR 1 

C0LPF1 

PF1 

— Playfield 1. 

C0L0R2 

C0LPF2 

PF2 

— Playfield 2. 

C0L0R3 

C0LPF3 

PF3 

— Playfield 3. 

C0L0R4 

COLBK 

BAK 

— Playfield background 

PCOLRO 

COLPMO 

PMO 

— Player/missi le 0. 

PCOLR1 

COLPM1 

PM1 

— Play er /mi ss i 1 e 1. 

PC0LR2 

C0LPM2 

PM2 

— Player/missi le 2. 

PC0LR3 

C0LPM3 

PM3 

— Player/missile 3. 


Theory of Operation 

The Display Handler automat ical ly sets up all memory resources 
required to create and maintain the screen display at OPEN time. 
The screen generation hardware requires that two distinct data 
areas exist for graphics modes: 1) a display list and 2) a 

screen data region. A third data area must exist for text modes. 
This data area defines the screen representation for each of the 
text characters. Consult the ATARI Home Computer 

Hardware Manual for a complete unders tand ing of the material that 
is to follow. 
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The simplified block diagram below shows the relationships 
between the memory and hardware registers used to set up a screen 
display (without player /missile graphics) by the OS Note that 
the hardware registers allow for many other possibilities. 


DATA BASE 


HARDWARE 

VARIABLE 


REGISTER 



(Updated every 



VBLANK > 

4 

-4 


! MEMTOP 

« 

1 


4 

i 

+ 

t 


1 

4 4 

< 



* + 

I C 
I I 

+ 4* + + 

S Display ! ! SDLSTL f 

« List { + + 

= = ! SDLSTH ! 


4 + 4 + 


1 

• 

{ 4 

— 4 

! Screen Data 

! < — SAVMSC 

1 

1 

s 

= 4 

4 

! Graphics 

i i 

• < 

1 

1 

! and/or 

{ 4 

— 4 

5 Text 

1 

t 



+ + 

End of RAM memory 


4 + ; 

\ DLISTL I ! 

+“+ 

! DLISTH I 

i i 

i i 

4 4 


4 


{ 4 4 4 + { 

\ \ CHBAS=EO \ > ! CHBASE 4- 4- 

« 4 4 4 4 

4 4 4 

! Specials and! EOOO 

« Numbers > 

4 4 

! Capital ElOO 

! Letters \ 

4 4 

‘Special ! E200 

« Graphics ! 

4 4 

' Lowercase ! E300 

! Letters 5 

4 4 
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+ 

! COLOR 0 


■+ 


COLOR 1 l 
COLOR 2 I 
COLOR 3 i 
COLOR 4 ! 


j COLPFO 
>{ COLPF1 
! C0LPF2 
! C0LPF3 
! COLBK 


Figure 5-8 Screen Display Block Diagram 

The following relationships are present in the preceding diagram: 

1. Data base variables SDLSTL/SDLSTH contain the address of 
the current display list. This address is stored in the 
hardware display list address registers DLISTL and DLISTH 
as part of the VBLANK process. 

2. The display list itself defines the charac ter ist ics of the 
screen to be displayed and points to the memory containing 
the data to be displayed. 

3. Data base variable CHBAS contains the MSB of the base address 
of the character representations for the character data (text 
modes only). 

The default value for this variable is $E0. This variable 
declares that the character representations start at memory 
address EOOO (the character set provided by the OS in ROM). 
Each character is defined as an 8X8 bit matrix# requiring 8 
bytes per character. 1024 bytes are required to define the 
largest set# since a character code contains up to 7 
significant bits (set of 128 characters). The OS ROM contains 
the default set in the region from EOOO to E3FF. 

All character codes are converted by the handler from ATASCII 
to an internal code (and vice versa)# as shown below: 


ATASCII 

CODE 

00- IF 
20-3F 
40-5F 
60-7F 
80-9F 
AO-BF 
CO-DF 
EO-FF 


INTERNAL 

CODE 

40- 5F 
00- IF 
20-3F 
60-7F 
CO-DF 
80-9F 
AO-BF 
EO-FF 
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The character set in ROM is ordered by internal code order. Three 
considerat ions differentiate the internal code from the external 
(ATASCII) code: 

ATASCII codes for all but the special graphics characters uiere to 
be similar to ASCII. The alphabetic# numeric# and punctuation 
character codes are identical to ASCII. 

In text modes 1 and 2 it was desired that one character subset 
include capital letters# numbers# and punctuation and the other 
character subset include lowercase letters and special graphics 
charac ters. 

The codes for the capital and lowercase letters were to be 
identical in text modes 1 and 2. 

Database variables COLORO through C0L0R4 contain the current 
color register assignments. Hardware color registers receive 
these values as part of the stage 1 VBLANK process# thus 
providing synchronized color changes (see Appendix H). 

Database variable SAVMSC points to the lowest memory address of 
the screen data region. It corresponds to the data displayed at 
the upper left corner of the display. 

When the Display Handler receives an open command# it first 
determines the screen mode from the OPEN IOCB. Then it allocates 
memory from the end of RAM downward (as specified by data base 
variable RAMTOP)# first for the screen data and then for the 
display list. The screen data region is cleared and the display 
list is created if sufficient memory is available. The display 
list address is stored to the database. 
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Screen Editor <E: > 


The Screen Editor is a read/write handler that uses the Keyboard 
Handler and the Display Handler to provide “ 1 ine-a t-a-t ime" input 
with interactive editing functions# as well as formatted output. 


The Screen Editor supports the following CIO functions: 

OPEN 

CLOSE 

GET CHARACTERS 
GET RECORD 
PUT CHARACTERS 
PUT RECORD 

GET STATUS (null function) 


See Keyboard Handler and Display Handler Sections for a 
discussion of Screen Editor error statuses. 

The Screen Editor is one of the resident handlers# and 
therefore has a set of device vectors starting at location 
E400. 

The Screen Editor is a program that reads key data from the 
Keyboard Handler and sends each character to the Display Handler 
for immediate display. The Screen Editor also accepts data from 
you to send to the Display Handler# and reads data from the 
Display Handler (not the Keyboard Handler) for you. In fact# 
the Keyboard Handler# Display Handler# and the Screen Editor are 
all contained in one monolithic hunk of code. 

Most of the behaviors already defined for the Keyboard Handler 
and the Display Handler apply as well to the Screen Editor: The 
discussions in this Section will be limited to deviations from 
those behaviors# or to additional features that are part of the 
Screen Editor only. The Screen Editor deals only with text data 
(screen mode 0). This Section also explains the sp 1 i t~scr een 
conf igurat ion feature. 

The Screen Editor uses the Display Handler to read data from 
graphics and text screens on demand. You use the Screen 
Editor to determine when the program will read Screen data# and 
where upon the screen the data will be read from. You 
first locates the cursor on the screen to determine the screen 
area to be read# you then press the [RETURN! key to determine 
when the program will begin to read the data indicated. 
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When the CRETURN3 key is pressed, the entire logical line within 
that the cursor resides is then made available to the calling 
program: Trailing blanks in a logical line are never returned as 
data, however. After all of the data in the line has been sent to 
the caller (this can entail multiple READ CHARACTERS functions if 
desired), an EOL character is returned and the cursor is 
positioned to the beginning of the logical line following the one 
just read. 


CIO Function Descriptions 

The device-specific charac ter ist ics of the standard CIO 
functions are detailed below: 


OPEN 

The device name is E, and the Screen Editor ignores any 
device number and filename specification, if included. 

The Screen Editor supports the following option: 


AUX1 


7 0 

\ ! W I R i 1 F ! 

•+•— + — I b -+-+ — ► — h — b 


Where : 


R and 
F = 1 


W are the direction bits 
indicates that a “forced 
CHARACTER and GET RECORD 


(read and write). 

read” is desired (see GET 

for more information). 


CLOSE 

No special handler actions. 


GET CHARACTER and GET RECORD 

Normally the Screen Editor will return data only when you press the 
CRETURN3 key at the keyboard. However, the “forced read” OPEN option 
allows you to read text data without intervention. When you command 
READ operation, the Screen Editor will return data from the start of 
the logical line in which the text cursor is located, and then 
move the cursor to the beginning of the following logical line. A 
read of the last logical line on the screen will cause the screen 
data to scroll. 

A special case occurs when characters are output without a 
terminating EOL, and then additional characters are appended to 
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that logical line from the keyboard. When the CRETURN3 key is 
pressed/ only the keyboard entered characters are sent to the 
caller/ unless the cursor has been moved out of and then back 
into the logical line/ in that case all of the logical line will 
be sent. 


PUT CHARACTER and PUT RECORD 

The Handler accepts ATASCII characters as one character per byte. 
Sixteen of the 256 ATASCII characters are control codes/ the EOL 
code has universal meaning, but most of the other control codes 
have special meaning only to a display or print device. The 
Screen Editor processing of the ATASCII control codes is 
explained below: 


CLEAR ($7D) — The Screen Editor clears the current display of 
all data and the cursor is placed at the home position (upper 
left corner of the screen). 


CURSOR UP ($1C) — The cursor moves up by one physical line. The 
cursor will wrap from the top line of the display to the bottom 
line. 


CURSOR DOWN ($1D) — The cursor moves down by one physical line. 
The cursor will wrap from the bottom line of the display to the 
top line. 


CURSOR LEFT ($1E) — The cursor moves left by one column. The 
cursor will wrap from the left margin of a line to the right 
margin of the same line. 


CURSOR RIGHT ($1F) — The cursor moves right by one column. The 
cursor will wrap from the right margin of a line to the left 
margin of the same line. 


BACKSPACE ($7E) — The cursor moves left by one column (but never 
past the beginning of a logical line), and the character at that 
new position is changed to a blank ($20). 
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SET TAB <$9F) — The Screen Editor establishes a tab point at the 
logical line position at that the cursor is residing. The logical 
line tab position is not synonymous with the physical line column 
position since the logical line can be up to 3 physical lines in 
length. For example* tabs can be set at the 15th* 30th* 45th* 

60th and 75th character positions of a logical line as shown 
below: 


029 19 29 39 Screen column #. 

— 1_ + + + R L/R = margins. 

x x T T A logical line. 

xx — T T T~ x = inaccesible 

x x columns. 


Note the effect of the left margin in defining the limits of the 
logical line. 


The Handler default tab settings are shown below: 


0 2 

L 


9 


19 

29 

39 

. Cl 

Screen column #. 
L/R = margins. 








x xT — 

— T - 

— 

T 

T — 

T- 

T 

A logical line. 

x x 

— T- 

— 

T 

T — 

T- 

T 

x *= inaccesible 

X x 

— T- 


T— 

T- 

T- 

T 

columns. 

CLEAR TAB 

<*9E> 

— The 

Screen 

Ed i tor 

clears the current cursor 

position 

within 

the logical line from 

being a 

tab point. There 


no “clear all tab points" facility provided by the Handler. 


TAB <$7F) — The cursor moves to the next tab point in the 
current logical line* or to the beginning of the next line if no 
tab point is found. This function will not increase the logical 
line length to accommodate a tab point outside the current length 
(e. g. the logical line length is 38 characters and there is a tab 
point at position 50). 


INSERT LINE <$9D> — All physical lines at and below the physical 
line in that the cursor resides* are moved down by one physical 
line. The last logical line on the display can be truncated as a 
result. The blank physical line at the insert point becomes the 
beginning of a new logical line. A logical line can be split into 
two logical lines by this process* the last half of the original 
logical line being concatenated with the blank physical line 
formed at the insert point. 
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DELETE LINE ($90 — The logical line in that the cursor resides 
is deleted and all data belou/ that line is moved upward to fill 
the void. Empty logical lines are created at the bottom of the 
disp lay. 


INSERT CHARACTER ($FF) — All physical characters at and behind 
the cursor position on a logical line are moved one position to 
the right. The character at the cursor position is set to blank. 
The last character of the logical line will be lost when the 
logical line is full and a character is inserted. The number of 
physical lines comprising a logical line can increase as a result 
of this function. 


DELETE CHARACTER <$FE) — The character on which the cursor 
resides is removed* and the remainder of the logical line to the 
right of the deleted character is moved to the left by one 
position. The number of physical lines composing a logical line 
can decrease as a result of this function. 


ESCAPE <$1B> — The next non-EOL character following this code is 
displayed as data* even if it would normally be treated as a 
control code. The sequence CESC3CESC3 will cause the second CESC3 
character to be displayed. 


BELL ($FD> — An audible tone is generated; the display is not 
modified. 


END OF LINE ($9B> — In addition to its record termination 
function* the EOL causes the cursor to advance to the beginning 
of the next logical line. When the cursor reaches the bottom line 
of the screen* the receipt of an EOL will cause the screen data 
to scroll upward by one logical line. 


GET STATUS 

The Handler takes no action other than to set the status to $01. 


User-Alterable Data Base Variables 

Also see the Display Handler data base variable discussion. 
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Cursor Position 


When in a split-screen configuration# ROWCRS and CQLCRS are associated 
with the graphics portion of the display and two other variables# 
TXTROW C02903 and TXTCOL C02913# are associated with the text window. 
TXTROW is a single byte# and TXTCOL is 2-bytes with the least 
significant byte being at the lower address. Note that the most 
significant byte of TXTCOL should always be zero. 

The home position (0,0) for the text window is the upper left corner 
of the window. 


Enable/Inhibit of Control Codes in Text 

Normally all text mode control codes are operated upon as received# 
but sometimes it is desirable to have the control codes displayed as 
if they were data characters. This is done by setting the variable 
DSPFLO C02FE3 to any nonzero value before outputting the data 
containing control codes. Setting DSPFLO to zero restores normal 
processing of text control codes. 
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Cassette Handler <C: ) 


The Cassette device is a read or write device with a Handler 
that supports the following CIO functions: 


OPEN 

CLOSE 

GET CHARACTERS 
GET RECORD 
PUT CHARACTERS 
PUT RECORD 

GET STATUS (null function) 


The Cassette Handler can produce the following error statuses: 


$80 — CBREAK3 key abort. 

$84 — Invalid AUX1 byte on OPEN. 

$88 — end-of-file. 

$8A-90 — SIO error set (see Appendix C>. 


The Cassette Handler is one of the resident handlers* and therefore 
has a set of device vectors starting at location E440. 


CIO Function Descriptions 

The device-specific charac ter istics of the standard CIO functions ar 
detailed below: 


OPEN 

The device name is C* and the Handler ignores any device number and 
filename spec if icat ion* if included. 

The Handler supports the following option: 
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AUX2 


7 O 

4 --+-+-+-+-+ -+-•+■-+ 
in i i 

« W « I 

+~-+-+--+~+~-+~+-~+~+ 

Where: C « 1 indicates that the cassette is to be read/uir i tten without 
stop/start between records (continuous mode). 

Opening the cassette for input generates a single audible tone* as a 
prompt for you to verify that the cassette player is set up 
for reading (power on# Serial Bus cable connected# tape cued to start 
of file# and PLAY button depressed). When the cassette is ready# 
you can press any keyboard key (except CBREAK3) to initiate tape 
reading. 

Opening the cassette for output generates two closely spaced audible 
tones# as a prompt for you to verify that the cassette player 
is set up for writing (as above# plus RECORD button depressed). When 
the cassette is ready# you can press any keyboard key (except 
CBREAK3) to begin tape writing. There is no way for the computer to 
verify that the RECORD or PLAY button is depressed. It is possible for 
the file not to be written# with no immediate indication of this fact. 

There is a potential problem with the cassette in that when the 
cassette is opened for writing# the motor keeps running until the 
first record (128 data bytes) is written. If 128 data bytes are 
written or the cassette is closed within about 30 seconds of the OPEN# 
and no other serial bus I/O is performed# then there is no problem. 
However# if those conditions are not met# some noise will be written 
to the tape prior to the first record and an error will occur when 
that tape file is read later. If lengthy delays are anticipated 
between the time the cassette file is opened and the time that the 
first cassette record (128 data bytes) is written# then a dummy record 
should be written as part of the file# typically 128 bytes of some 
innocuous data would be written# such as all zeros# all $FFs# or all 
blanks (*20). 

The system sometimes emits whistling noises after cassette I/O has 
occurred. The sound can be eliminated by storing $G3 to SKCTL CD20F3# 
thus bring POKEY out of the two-tone (FSK) mode. 


CLOSE 

The CLOSE of a tape read stops the cassette motor. 

The CLOSE of a tape write does the following: 

Writes any remaining user data in the buffer to tape. 
Writes an end-of-file record. 

Stops the cassette motor. 


OPERATING SYSTEM C016555 


Section 5 


73 



GET CHARACTERS and GET RECORD 


The Handler returns data in the following format: 


7 0 

+— + — + — h — ► 

< data byte « 

+~+-4— +-+-+~+ — 


PUT CHARACTERS and PUT RECORD 
The Handler accepts data in the following format: 

7 O 

+— + — h— +-4— +- + — I-- + 

2 data byte ! 

+-+-+—+ — h — > — 4- — h-+ 

The Handler attaches no significance to the data bytes 
written* a value of $9B (EOL) causes no special action. 


GET STATUS 

The Handler does no more than set the status to $01. 


Theory of Operation 

The Cassette Handler writes and reads all data in fixed-length records 
of the format shown below: 


Figure 5-9 


+_+_ + _. 4 ._+_+_+_+._ 4 . 

{ 01010101 .* 

2010101012 
+—+ — 4. — 4. — 4 — — ■+• — )■ 

1 control byte ! 

■+• — h — -i ► — 4 4 4 4 

{ 128 ! 

= data = 

i bytes 2 

* checksum 2 

+~+-+-+-+-+-+ — +-+ 

Cassette Handler Record 


Speed measurement bytes. 


(Managed by SIO/ not the 
Handler. ) 

Format 
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The control byte contains one of three values: 

o $FC indicates the record is a full data record (128 bytes). 

o $FA indicates the record is a partially full data record; you 
supplied fewer than 128 bytes to the record. This case can 
occur only in the record prior to the end-of-file. The number 
of user-supplied data bytes in the record is contained in the 
byte prior to the checksum. 

o *FE indicates the record is an End-of file record; the data 
portion is all zeroes for an end-of-file record. 

The SIO routine generates and checks the checksum. It is part of the 
tape record/ but it is not contained in the Handler's record buffer 
CASBUF C03FD3. 

The processing of the speed-measurement bytes during cassette reading 
is discussed in Appendix L# D1-D7. 


File Structure 

The Cassette Handler writes a file to the cassette device with a file 
structure that is totally imposed by the Handler (soft format). A file 
consists of the following three elements: 

o A 20-second leader of mark tone. 

o Any number of data-record frames. 

o An end-of-file frame. 


The cassette-data record frames are formatted as shown below: 


frame = pre-record write tone (PRWT)# 

+ data record# 

+ post record gap (PRO) 

The nondata portions of a frame have character ist ics that are 
dependent upon the write OPEN mode# i. e. continuous or 
start/stop. 


Stop/start PRWT « 3 seconds of mark tone. 
Continuous PRWT » .25 second of mark tone. 


Stop/start PRG 
Continuous PRO 


up to 1 second of unknown tones. 

from 0 to n seconds of unknown tones# where 

n is dependent upon your program timing. 


The inter-record gap (IRO) between any two records consists of 
the PRO of the first record followed by the PRWT of the second 
record. 
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Printer Handler <P: ) 


The Printer device is a write-only device with a Handler that 
supports the following CIO functions: 

OPEN 

CLOSE 

PUT CHARACTERS 
PUT RECORD 
GET STATUS 

The Printer Handler can produce the following error statuses: 

$8A-90 — SIO error set (see Appendix C). 

The Printer Handler is one of the resident handlers# and 
therefore has a set of device vectors starting at location E430. 


CIO Function Descriptions 

The device-specific character istics of the standard CIO functions 
are detailed below: 


OPEN 

The device name is P. The Handler ignores any device number and 
filename spec if icat ion# if included. 


CLOSE 

The Handler writes any data remaining in its buffer to the 
printer device# with trailing blanks to fill out the line. 


PUT CHARACTERS and PUT RECORD 
The Handler accepts print data in the following format: 


7 O 

\ ATASC I I { 

+ — 

The only ATASCII control code of any significance to the Handler 
is the EOL character. The printer device ignores bit 7 of every 
data byte and prints a sub set of the remaining 128 codes, (see 
Appendix G for the printer character set). 

The Handler supports the following print option: 
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AUX2 


7 0 

+-+-+— +-+~+-+- 4 --+ 

! print mode 

+ h h h h h— + h h 

Where: $4E (N) selects normal printing (40 characters per line). 

$53 (S) selects sideways printing <29 characters per line). 
$57 (W) selects wide printing (not supported by printer 
device ) . 

Any other value (including 00) is treated as a normal (N) 
print select/ without producing an error status. 


GET STATUS 

The Handler obtains a 4-byte status from the printer 
controller and puts it in system location DVSTAT C02EA3. The 
format of the status bytes is shown below: 

! command stat. ! 

4. — f . — 4. — j. — y . — t-~~ 4 - — 4 — h 

I AUX2 of prev. I 
« timeout ! 

4. _ 4. — 4. _ 4. _ 4. _ 4. ~ 4. 4. — . 4. 

! ( unused ) ! 

4. — 4.— 4 - — ► H h >- b 

The command status contains the following status bits and 
condition indications: 

bit 0: an invalid command frame was received. 

bit 1: an invalid data frame was received. 

bit 7: an intelligent controller (normally = 0). 

The next byte contains the AUX2 value from the previous operation. 

The timeout byte contains a controller provided maximum timeout 
value (in seconds). 


Theory of Operation 

The ATARI 820CTM3 40-Column Printer is a 1 ine-at-a-t ime printer rather 
than a charac ter-at-a~t ime printer, so your data must be buffered by 
the Handler and sent to the device in records corresponding to one 
print line (40 characters for normal/ 29 characters for sideways). 


DVSTAT + O 
+ 1 
+ 2 
+ 3 
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The printer device does not attach any significance to the EOL 
character# so the Handler does the appropriate blank fill 
whenever it sees an EOL. 


Disk File Manager (D: ) 

The OS supports four unique File Management Subsystems at the 
time of this writing. Version IA is the original version. 

Version IB is a slightly modified version of IA and is the one 
described in this document. Most of this discussion applies as 
well to Version II/ that handles a double-density diskette <720 
256-byte sectors) in addition to the single-density diskette (720 
128-byte sectors). Version III has all new f i le/d irec tory/map 
structures and can possibly contain changes to your interface 
as well. 

The File Management Subsystem includes a disk-bootable 
(RAM-resident) Disk File Manager (DFM) that maintains a 
collection of named files on diskettes. Up to 4 disk drives 
(Dl: through D4 : ) can be accessed/ and up to 64 files per 
diskette can be accessed. The system diskettes supplied by ATARI 
allow a single disk drive (Dl) and up to 3 OPEN files/ but 
you can alter these numbers as described later in 
this section. 


The Disk File Manager supports the following CIO functions: 

OPEN FILE 
OPEN DIRECTORY 
CLOSE 

GET CHARACTERS 
GET RECORD 
PUT CHARACTERS 
PUT RECORD 
GET STATUS 


NOTE 

POINT 

LOCK 

UNLOCK 

DELETE 

RENAME 

FORMAT 
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The Disk Fi 

*03 — 
*88 — 
*8A-90 
*A0 — 
*A1 — 
*A2 — 
*A3 — 
*A4 — 
*A5 — 
*A6 — 
*A7 — 
*A8 — 
*A9 — 
*AA — 
*AB — 


1 e Manager can produce the following error statuses: 

Last data from file (EOF on next read), 
end-of-f i le. 

— SIO error set (see Appendix C). 

Drive number specification error. 

No sector buffer available (too many open files). 
Disk full. 

Fatal I/O error in directory or bitmap. 

Internal file # mismatch (structural problem). 

File name specification error. 

Point information in error. 

File locked to this operation. 

Special command invalid. 

Directory full (64 files). 

File not found. 

Point invalid (file not OPENed for update). 


CIO Function Descriptions 

The device-specific charac ter ist ics of the standard CIO functions 
are detailed below: 


OPEN FILE 

The device name is D. Up to four disk drives can be accessed (D1 
through D4>. The disk filename can be from 1 to 8 characters in 
length with an optional 1- to 3-character extension. 

The OPEN FILE command supports the following options: 


AUX1 


7 0 

i « W * R « iAS 




Where: W and R are the direction bits. 

WR =00 is invalid 

01 indicates OPEN for read only. 

10 indicates OPEN for write only. 

11 indicates OPEN for read/write (update). 


A * 1 indicates appended output when W = 1. 
You may use these following valid AUX1 options: 
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OPEN Input (AUXi = $04) 


The indicated file is opened for input. Any wild-card characters 
are used to search for the first match. If the file is not found# 
an error status is returned# and no file will be opened. 


OPEN Output (AUXI » $08) 

The indicated file is opened for output starting with the first 
byte of the file# if the file is not locked. Any wild-card 
characters are used to search for the first match. If the file 
already exists# the existing file will be deleted before opening 
the named file as a new file. If the file does not already exist# 
it will be created. 

A file opened for output will not appear in the directory until 
it has been closed. If an output file is not properly closed# 
some or all of the sectors that were acquired for it can be lost 
until the disk is reformatted. 

A file that is opened for output can not be opened concurrently 
for any other access. 


OPEN Append (AUXI = $09) 

The indicated file is opened for output starting with the byte 
after the last byte of the existing file (that must already 
exist)# if the file is not locked. Any wild-card characters are 
used to search for the first match. 

If a file opened for append is not properly closed# the appended 
data will be lost. The existing file will remain unmodified and 
some or all of the sectors that were acquired for the appended 
portion can be lost until the diskette is reformatted. 


OPEN Update (AUXI = $0C ) 

The indicated file (that must already exist) will be opened for 
update provided it is not locked. Any wild-card characters are 
used to search for the first match. 

The GET# PUT# NOTE and POINT operations are all valid# and can be 
intermixed as desired. 

If a file opened for update is not properly closed# a sector's 
worth of information can be lost to the file. A file opened for 
update can not be extended. 
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Device/Fi lename Specification 


The Handler expects to find a device/filename specification of 
the following form: 


DCCnumberM: <f i lename><EOL> 
where: 

<number> : : = 1.2 {31 4 

<filename> ::= CCpr imary>3C. CCe xtens ion>3 3<terminator> 

<primary> : : = an uppercase alpha character followed by O to 7 
alphanumeric characters. If the primary name is 
less than 8 characters* it will be padded with 
blanks* if it is greater than 8 characters* the 
extra characters will be ignored. 

<extension> ::= Zero to 3 alphanumeric characters. If the 
extension name is missing or less than 3 
characters* it will be padded with blanks* if 
it is greater than 3 characters* the extra 
characters will be ignored. 

<terminator> ::= <EQL> {<b lank> 


Figure 5-10 Device/Fi lename Syntax 


The following are all valid device/filenames for the diskette: 

D1 : GAME. SRC 
D: MANUAL6 
D: . WHY 
D3: FILE. 

D4: BRIDGE. 002 


Filename Wildcarding 

The filename specification can be further generalized to include 
the use of the “wi Id-card " characters * and ?. These wildcard 
characters allow portions of the primary and/or extension to be 
abbreviated as follows: 

The ? character in the specification allows any filename 
character at that position to produce a “match. “ For example* WH? 
will match files named WHO* WHY* WH4* etc.* but not a file named 
WHAT. 
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The * character causes the remainder of the primary or extension 
field in that it is used to be effectively padded with ? 
characters. For example/ WH* will match WHO/ WHEN/ WHATEVER/ etc. 

Some valid uses of wild-card specif ications are shown below: 

Files having an extension of SRC. 

Files named BASIC with any extension. 

All files. 

Files beginning with H and having a 0 or 1 
character extension. 

If wildcarding is used with an OPEN FILE command/ the first file 
found (if any) that meets the specification will be the one (and 
only one) opened. 


OPEN DIRECTORY 

The OPEN DIRECTORY command allows you read directory 
information for the selected filename(s)/ using normal GET 
CHARACTERS or GET RECORD commands. The information read will be 
formatted as ATASCII records/ suitable for printing/ as shown 
below. Wildcarding can be used to obtain information for multiple 
files or the entire diskette. 

The OPEN DIRECTORY command uses the same CIO parameters as a standard 
OPEN FILE command: 

COMMAND BYTE = $03 

BUFFER ADDRESS = pointer to devic e/f i lename specification. 

AUX1 ■ $06 

After the directory is opened/ a record will be returned to the 
caller for each file that matches the OPEN spec if ication. The 
record/ that contains only ATASCII characters/ is formatted as 
shown below: 


*. SRC 
BASIC. * 
*. * 

H*. ? 


1 

123456789012345678 

+ — b — +~+— + 

Islbl primary name ! ext !b ‘count lei 

•+• f- — + > h l -J h — } b b — i j ^ 
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Where: s = # or ' '# with * indicating file locked, 
b * blank. 

primary name = lef t-just i f ied name with blank fill, 
ext * left-justified extension with blank fill, 
b = blank. 

count = number of sectors comprising the file, 
e ■ EOL <$9B>. 

After the last filename match record is returned# an additional 
record is returned. This record indicates the number of unused 
sectors available on the diskette. The format for this record is shown 
below: 


1 

12345678901234567 

+ — »--+-•+• — h — — h — K--+ — I ►-- + -+ — h- + — h-4- 

Icounti FREE SECTOR Slel 

+_+_+_+_+_ 4 ._+_+ — >._+ 

Where: count * the number of unused sectors on the diskette, 
e » EOL <$9B>. 

The EOF statuses ($03 and $88) are returned as in a normal data 
file when the last directory record is read. 

The opening of another diskette file while the directory read is 
open will cause subsequent directory reads to malfunction# so 
care must be taken to avoid this situation. 


CLOSE 

Upon closing a file read# the Handler releases all internal 

resources being used to support that file. 

Upon closing a file write# the Handler: 

o writes any residual data from its file buffer for that file 
to the diskette. 

o updates the directory and allocation map for the associated 
diskette. 

o releases all internal resources being utilized to support 
that file 


GET CHARACTERS and GET RECORD 

Characters are read from the diskette and passed to CIO as a raw 
data stream. None of the ATASCII control characters have any 
special significance. A status of $88 is returned if an attempt 
is made to read past the last byte of a file. 
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PUT CHARACTERS and PUT RECORD 


Characters are obtained from CIO and written to the diskette as a raw 
data stream. None of the ATASCII control characters have any special 
significance. 


GET STATUS 

The indicated file is checked and one of the following status 
byte values is returned in ICSTA and register Y: 

$01 — File found and unlocked. 

$A7 — File locked. 

$AA — File not found. 


Special CIO Functions 

The DFM supports a number of SPECIAL commands* that are device 
specific. These are explained in the paragraphs that follow: 


NOTE (COMMAND BYTE « $25) 

This command returns to the caller the exact diskette location of 
the next byte to be read or written* in the variables shown 
below: 

ICAX3 * LSB of the diskette sector number. 

ICAX4 = MSB of the diskette sector number. 

ICAX5 = relative sector displacement to byte (0-124). 


POINT (COMMAND BYTE = $26) 

This command allows you to specify the exact diskette location of 
the next byte to be read or written. In order to use this commmand* 
the file must have been opened with the "update” option. 

ICAX3 * LSB of the diskette sector number. 

ICAX4 = MSB of the diskette sector number. 

ICAX5 ~ relative sector displacement to byte (0-124). 
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LOCK 


This command allows you to prevent write access to any 
number of named files. Locked files can not be deleted/ renamed/ 
nor opened for output unless they are first unlocked. Locking a 
file that is already locked is a valid operation. The Handler 
expects a device/f i lename specification/ then all occurrences of 
the filename specified will be locked/ using the wild-card rules 

You set up these following IQCB parameters prior to 
calling CIO: 

COMMAND BYTE = *23 

BUFFER ADDRESS *= pointer to devic e/f i lename specification. 

After a LOCK operation/ the following IOCB parameter will have 
been altered: 

STATUS « result of LOCK operation; see Appendix B for a list 
of possible status codes. 


UNLOCK 

This command allows you to remove the lock status of any 
number of named files. Unlocking a file that is not locked is a 
valid operation. The Handler expects a device/filename 
specification; then all occurrences of the filename specified 
will be unlocked/ using the wild-card rules. 

You set up these following IOCB parameters prior to 
calling CIO: 

COMMAND BYTE = *24 

BUFFER ADDRESS * pointer to device/f i lename specification. 

After an UNLOCK operation/ the following IOCB parameter will have been 
altered : 

STATUS = result of UNLOCK operation; see Appendix B for a 
list of possible status codes. 


DELETE 

This command allows you to delete any number of unlocked 
named files from the directory of the selected diskette and to 
deallocate the diskette space used by the files involved. The 
Handler expects a device/filename spec if icat ion; then all 
occurences of the filename specified will be deleted/ using the 
wild-card rules. 
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You set up these following IOCB parameters prior to 
calling CIO: 

COMMAND BYTE « $21 

BUFFER ADDRESS = pointer to device/f i lename specif ication. 

After a DELETE operation/ the following IOCB parameter will have 
been altered: 

STATUS = result of DELETE operation; see Appendix B for a list of 
possible status codes. 


RENAME 

This command allows you to change the filenames of any 
number of unlocked files on a single diskette. The Handier 
expects to find a device/filename specif ication that follows: 

<device spec>: <f i lename spec>, <f i lename spec>CEOL> 

All occurrences of the first filename will be replaced with the 
second filename/ using the wild-card rules. No protection is 
provided against forming duplicate names. Once formed/ duplicate 
names cannot be separately renamed or deleted; however/ an OPEN 
FILE command will always select the first file found that matches 
the filename spec if ication/ so that file will always be 
accessible. The RENAME command does not alter the content of the 
files involved/ merely the name in the directory. 

Examples of some valid RENAME name spec if ications are shown 
below: 

Dl: *. SRC, *. TXT 
D: TEMP, FD ATA 
D2: F*, F*. OLD 

You set up these following IOCB parameters prior to 
calling CIO: 

COMMAND BYTE = $20 

BUFFER ADDRESS * pointer to device/filename spec if icat ion. 

After a RENAME operation/ the following IOCB parameter will have 
been altered: 

STATUS = result of RENAME operation; see Appendix B for a 
list of possible status codes. 
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FORMAT 


Soft-sector diskettes must be formatted before they can store 
data. The FORMAT command allows you to physically format a 
diskette. The physical formatting process writes a new copy of 
every sector on the soft— sec tored diskette# with the data portion 
of each sector containing all zeros. The FORMAT process creates 
an “empty" non system diskette. When the formatting process is 
complete# the FMS creates an initial Volume Table of Contents 
(VTGC) and an initial File Directory. The boot sector (#1) is 
permanently reserved as part of this process. 

You set up these following IOCB parameters prior to 
calling CIO: 

COMMAND BYTE * *FE 

BUFFER ADDRESS = pointer to device spec if icat ion. 

After a FORMAT operation# the following IOCB parameter will have 
been altered: 

STATUS = result of FORMAT operation# see Appendix B for a 
list of possible status codes. 

To create a system diskette# a copy of the boot file must then be 
written to sectors #2-n. This is accomplished by writing the file 
named DOS. SYS. This is a name that is recognized by the FMS even 
though it is not in the directory initially. 


Theory of Operation 

The resident OS initiates the disk-boot process (see Section 10). 
The OS reads diskette sector #1 to memory and then transfers 
control to the "boot continuation address" (boot address + 6). 

The boot-continuation program contained in sector #1 then 
continues to load the remainder of the File Management Subsystem 
to memory using additional information contained in sector #1. 

The File Management Subsystem loaded# will contain a Disk File 
Manager # and optionally# a Disk Utilities (DOS) package. 

When the boot process is complete# the Disk File Manager will 
allocate additional RAM for the creation of sector buffers. 

Sector buffers are allocated based upon information in the boot 
record as shown below: 

Byte 9 = maximum number of open files# one buffer per (the 
maximum value is 8). 

Byte 10 = drive select bits# one buffer per (1-4 only). 
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The Disk File Manager will then insert the name D and the Handler 
vector table address in the device table. 

NOTE: There is a discrepancy between the Disk File Manager's 
numbering of diskette sectors <0-719) and the disk controller's 
numbering of diskette sectors <1-720); as a result/ only sectors 
1- 719 are used by the Disk File Manager. 

The Disk File Manager uses the Disk Handler to perform all 
diskette reads and writes; the DFM's function is to support and 
maintain the direc tory/f i le/b i tmap structures as described in the 
following pages: 
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FMS Diskette Utilization 


The map below shows the diskette sector utilization for a 
standard 720 sector diskette. 


+ + 

« BOOT record I Sector 1 

+ + 

« FMS BOOT ! Sector 2 -+ 

= file = « 

* DOS. SYS «* Sector n +- Note 1 

+ + ! 

! User Sector n+1 -+ 

= File » 

! Area I Sector 359 (*167) 

+ 4. 

i VTOC (note 2) i Sector 360 (*168) 

+ + 

« File ‘ Sector 361 (*169) 

= Directory = 

{ { Sector 368 (*170) 

« User * 

= File = 

i Area i Sector 719 (*2CF) 

4.__— — •■—4. 

I unused ! Sector 720 (*2D0> 

4. + 


Figure 5~11 File Management Subsystem Diskette Sector Utilization 
Map 


NOTE 1 - If the diskette is not a system diskette/ then your 
File Area starts at sector 2 and no space is reserved for the FMS 
BOOT file. However, ,, DOS ,, (DOS. SYS and DUP. SYS) may still be 
written to a diskette that has already used sectors "2-N. " 

NOTE 2 — VTOC stands for Volume Table of Contents. 
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FMS Boot Record Format 


The FMS BOOT record (sector #1) is a special case of diskette-booted 
software (see Section 10). The format for the FMS BOOT record is 
shown below: 


4 + 

{ boot flag * 0 « Byte 0 

4 + 

! # sectors = 1 ! 1 

4 + 

! bootaddress i 2 

4 - + 

I = 0700 { 

+ 4 

! initaddress ! 4 

+ + 

i i 

* i 

4 4. 

! JMP = *4B i 6 

4 * 4 - 

! boot read S 

+ continuation + 

! address S 

4 —— — —+ 4 

! max files = 3 ! I 9 Notel 

I drive bits = 1 ! ! 10 Note 2 

4. 4. I 

i alloc dire * 0 ! I 11 Note 3 

4. 4. j 

! boot image end ! ! 

4 + ! FMS 

* address 4 1 { 4- configuration 

4 4 { data 

'boot flag OO S ! 14 Note 4 

4. 4. « 

« sector count « { 15 Note 5 

4. + { 

« DOS. SYS I { 

4 starting 4 ! 

« sector number ! ♦ 

4. 4. 4. 


code for second 
phase of boot 


Figure 5-12 File Management Subsystem Boot Record Format 
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NOTE 1 - Byte 9 specifies the maximum number of concurrently open 
files to be supported. This value can range from 1 to 8. 


NOTE 2 - Byte 10 specifies the specific disk drive numbers to be 
supported using a bit encoding scheme as shown below: 

7 6 5 4 3 2 1 0 

« «4!3«2«1! where a 1 indicates a selected drive. 

+“+-+— +“+-*+-+“+--+ 

NOTE 3 - Byte 11 specifies the buffer allocation direction/ this 
byte should equal 0. 

NOTE 4 - Byte 14 must be nonzero for the second phase of the boot 
process to initiate. This flag indicates that the file 
DOS. SYS has been written to the diskette. 

NOTE 5 - This byte is assigned as being the sector count for the 
DOS. SYS file. It is actually an unused byte. 
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Boot Process Memory Map 


The diagram below shows how the boot sector (part of file 
DOS. SYS) and following sectors are loaded to memory as part of 
the boot process. 


data 

from b 

oot 

; sector read 

by 

resident OS 


data 

from r 

est 

of DOS. SYS 


read 

by the 


program in 

the 

boot 

sector 

• 


Memory address 


0700 

< 

l 

I 

I 

077C 


077D 


end of boot 


Figure 5-13 File Management Subsystem Boot Process Memory Map 
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Volume Table of Contents 


The format for the FMS volume table of contents (VTOC, sector 
360) is shown in the diagram below: 


+ + 

I directory type { 

+ + 

! maximum (lo) i 
+ sector # + 

{ - 02C5 (hi) { 

+ + 

1 number of (lo) ,* 
+ sectors + 

! available (hi) i 
+ + 


Byte 0 Note 1 
1 Note 2 

3 Note 3 


+ + 

5 5 10 

= volume bit map = 

< i 

■ i 

+ 4 


4 4 

Figure 5-14 File Management Subsystem Volume Table of Contents 
The volume bit map organization location follows: 


7 0 

4— 4— 4— 4—4— 4— 4— -4— 4 

! 11 2 3 4 5 6 71 Byte 10 of VTOC 

4 — h-4-4-4-4-4-4-4 

18 9 ! 11 


4 — f — j-— 4—4— 4 — ) — ■+• — + 
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Figure 5-15 File Management Subsystem Volume Bit Map 

At each map bit position* a 0 indicates the corresponding sector 
is in use and a 1 indicates that the sector is available. 

NOTE 1 - The directory type byte must eq.ual 0. 

NOTE 2 - The maximum sector number is not used because it is 

incorrectly set to 709 decimal. The true maximum sector 
number is actually 719 for the DFM. 
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NOTE 3 - The number of sectors available is initially set to 709 
after a diskette is freshly formatted; this number is 
adjusted as files are created and deleted to show the 
number of sectors available. The sectors that are 
initially reserved are 1 and 360-368. 


File Directory Format 

The FMS reserves eight sectors (361-368) for a file directory. 
Each sector containing directory information for up to eight 
files* thus providing for a maximum of 64 files for any volume. 
The format of a single 16-byte file entry is shown below: 

Byte 0 
1 


3 


5 


13 


Figure 5-16 File Directory Format 

Where the flag byte has the following bits assigned: 
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flag byte 

sector 

count 

( lo) 


(hi) 

starting 

sector 

( lo) 

number 

(hi ) 


(1) 


(2) 


(3) 

file 

(4) 

name 

(5) 

pr imary 

(6) 


(7) 


(8) 

file 

(1) 

name 

(2) 

extension 

(3) 
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bit 7 ■ 1 if the file has been deleted, 

bit 6 = 1 if the file is in use. 

bit 5 = 1 if the file is locked, 

bit 0 « 1 if OPEN output. 

The flag byte can take on the following values: 

♦00 = entry not yet used (no file). 

♦40 = entry in use (normal CLOSEd file). 

♦41 = entry in use (OPEN output file). 

♦60 = entry in use (locked file). 

♦80 ■ entry available (prior file deleted). 

Sector count is the number of sectors comprising the file. 


FMS File Sector Format 

The format of a sector in your data file is shown below: 

7 0 

! data I +0 


-+• — h-+-+ — h — i — i — i — + 


! file # ! h i i 

+— ■ +_+— +— +— +-+ + 

+ 125 

{forward pointer! 

+- 4 -—+ 

+ 126 

!S! byte count ! 

+-+-+-+-+ — h-+-+-+ 

+ 127 


Figure 5-17 File Management Subsystem File Sector Format 


The FMS uses the file # to verify file integrity. The file # 
is a redundant piece of information. The file number field 
contains the value of the directory position of that file. If a 
mismatch occurs between the file's directory position* and the 
file number as contained in each sector* then the DFM will 
generate the error ^A4. 

The forward pointer field contains the 10-bit value for the 
diskette sector number of the next sector of the file. The 
pointer equals zero for the last sector of a file. 

The S bit indicates whether or not the sector is a “short sector" 
(a sector containing fewer than 125 data bytes). S is equal to 
1 when the sector is short. 
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The byte-count field contains the number of data bytes in the 
sector. 


Non-CIO I/O 

Some portions of the I/O subsystem are accessed independently of 
the Central I/O Utility <CIO)i this section discusses those 
areas. 


Resident Device Handler Vectors 

All of the OS ROM resident device handlers can be accessed via 
sets of vectors that are part of the OS ROM. These vectors 
increase the speed of I/O operations that utilize fixed device 
assignments# such as output to the Display Handler. For each 
resident Handler there is a set of vectors ordered as shown 
below: 


4 - — 

+- 

OPEN 

+ 

- 4 - 

+0 

+- 

CLOSE 

- 4 - 

4-2 

+.- 

GET BYTE 

- 4 - 

4-4 


PUT BYTE 

- 4 - 

+6 

4 -- 

GET STATUS 

- 4 - 

4-8 

+ - 

SPECIAL 

- 4 - 

+ 10 

+~ 

+- 

JMP 

INIT 

- 4 - 

+ 12 

+- 

+- 

4 - — 

SPARE 

BYTE 

~ + 

- 4 - 

+ 



Figure 5-18 Resident Device Handler Vectors 


See Section 9 for a detailed description of the data interface 
for each of these Handler entry points. 

Each of the vectors contains the address (lo#hi> of the Handler 
entry point minus 1. A technique similar to the one shown below 
is required to access the desired routines: 
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VTBASE=*E400 


; BASE OF VECTOR TABLE. 

LDX 

#x X 

i OFFSET TO DESIRED ROUTINE. 

LDA 

data 


JSR 

GOVEC 

i SEND DATA TO ROUTINE. 

LDX 


; OFFSET TO DIFFERENT ROUTINE 

JSR 

GOVEC 

; GET DATA FROM ROUTINE. 

STA 

data 



GOVEC TAY 


; SAVE REGISTER A. 

LDA 

VTBASE+1, X 

i ADDRESS MSB TO STACK 

PHA 



LDA 

VTBASE/ X 

i ADDRESS LSB TO STACK 

PHA 



TYA 


; RESTORE REGISTER A. 

RTS 


; JUMP TO ROUTINE. 


The JMP INIT slot in each set of vectors jumps to the Handler 
initial i zation entry (not minus 1). 

The base address of the vector set for each of the resident 
handlers is shown below: 


Screen Editor (E: ) E400. 
Display Handler <S: > E410. 
Keyboard Handler <K: ) E420. 
Printer Handler (P: ) E430. 
Cassette Handler (C: > E440. 


The resident diskette Handler is not C IO-compat ib le» so its 
interface does not use a vector set. 


Resident Diskette Handler 

The resident Diskette Handler (not to be confused with the Disk 
File Manager) is responsible for all physical accesses to the 
diskette. The unit of data transfer for this Handler is a single 
diskette sector containing 128 data bytes. 

Communicat ion between you and the Diskette Handler is 
effected using the system's Device Control Block (DCB), that is 
also used for Handler/SIG communication (see Section 9). The DCB 
is 12 bytes long. Some bytes are user-a 1 terab le and some are for 
use by the Diskette Handler and/or the Serial I/O Utility (SIO). 
You supply the required DCB parameters and then do a JSR 
DSKINV CE4533. 


OPERATING SYSTEM C016555 


Section 5 


97 



Each of the DCB bytes will now be described/ and the 
sy stem-equate file name for each will be given. 


SERIAL BUS ID — DDEVIC C 0300 3 

The Diskette Handler sets up this byte to contain the Serial Bus ID 
for the drive to be accessed. It is not user-a 1 terab le. 


DEVICE NUMBER — DUNIT C 0301 3 

You set up this byte to contain the disk drive number to be 
accessed (1 - 4). 


COMMAND BYTE — DCOMND C 0302 3 

You set up this byte to contain the disk device command to 
be performed. 


STATUS BYTE — DSTATS C 0303 3 

This byte contains the status of the command upon return to the 
caller. See Appendix C for a list of the possible status codes. 


BUFFER ADDRESS — DBUFLO C03043 and DBUFHI C03053 

This 2-byte pointer contains the address of the source or 
destination of the diskette sector data. You need not supply 
an address for the disk status command. The Disk Handler will 
obtain the status and insert the address of the status buffer 
into this field. 


DISK TIMEOUT VALUE — DTIMLO C 0306 3 

The Handler supplies this timeout value (in whole seconds) for 
use by SIO. 


BYTE COUNT — DBYTLO C03083 and DBYTHI C03093 

This 2-byte counter indicates the number of bytes transferred to 
or from the disk as a result of the most recent command/ and is 
set up by the Handler. 


SECTOR NUMBER — DAUX1 C030A3 and DAUX2 C030B3 

This 2-byte number specifies the diskette sector number (1 - 720) 
to read or write. DAUX1 contains the least significant byte/ and 
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DAUX2 contains the most significant byte. 


Diskette Handler Commands 

There are five commands supported by the Diskette Handler: 

GET SECTOR (PUT SECTOR — *** not supported by current handler ***) 
PUT SECTOR WITH VERIFY 
STATUS REQUEST 
FORMAT DISK 


GET SECTOR (Command byte = $52) 

The Handler reads the specified sector to your buffer and returns the 
operation status. You set the following DCB parameters prior to 
calling the Diskette Handler: 

COMMAND BYTE = *52. 

DEVICE NUMBER * disk drive number (1-4). 

BUFFER ADDRESS = pointer to your 128-byte buffer. 

SECTOR NUMBER = sector number to read. 

Upon return from the sector# several of the other DCB parameters 
will have been altered. The STATUS BYTE will be the only 
parameter of interest to you# however. 


PUT SECTOR (Command byte = *50) 

Not supported by current Handler **••* 

(But can be accessed through SIO directly. ) 

The Handler writes the specified sector from your buffer and returns 
the operation status. You set the following DCB parameters prior to 
calling the Diskette Handler: 

COMMAND BYTE » *50. 

DEVICE NUMBER * disk drive number (1-4). 

BUFFER ADDRESS = pointer to your 128 byte buffer. 

SECTOR NUMBER * sector number to write. 

Upon return from the operation# several of the other DCB parameters 
will have been altered. The STATUS BYTE will be the only one of 
interest you# however. 
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PUT SECTOR WITH VERIFY (Command Byte = $57) 


The Handler writes the specified sector from your buffer 
and returns the operation status. This command differs from PUT 
SECTOR in that the diskette controller reads the sector data after 
writing to verify the write operation. Aside from the COMMAND 
BYTE value/ the calling sequence is identical to PUT SECTOR. 


STATUS REQUEST (Command byte = $53) 

The Handler obtains a 4-byte status from the diskette controller and 
puts it in system location DVSTAT C02EA3. The operation status 
format is shown below: 


7 


0 


+ 

1 

+ 

1 

+ 

1 

+ 

! 

+ 

1 

+ 

1 

+ 

1 

+ 

1 

+ 


« command stat. i 

J--+-+-+ — (--+-+ 

DVSTAT + 

« hardware stat. « 

— h — h-+ — h- -+ 

•f 

! timeout S 

+ 

« (unused) « 

+—+— +”+~+— f— +”+~+ 

+ 


Figure 5-19. DVSTAT 40-Byte Operation Status Format 

The command status contains the following status bits: 

Bit 0=1 indicates an invalid command frame was received. 

Bit 1=1 indicates an invalid data frame was received. 

Bit 2=1 indicates that a PUT operation was unsuccessful. 

Bit 3=1 indicates that the diskette is write protected. 

Bit 4=1 indicates ac tive/standby . 

The hardware status byte contains the status register of the 
INS1771-1 Floppy Diskette Controller chip used in the diskette 
controller. See the documentat i on for that chip to obtain 
information relating to the meaning of each bit in the byte. 

The timeout byte contains a control ler-provided maximum timeout 
value (in seconds) to be used by the Handler. 

You set the following DCB parameters prior to calling 
the Diskette Handler: 

COMMAND BYTE = $53. 

DEVICE NUMBER = disk drive number (1-4). 

Upon return from the operation/ several of the other DCB parameters 
will have been altered. The STATUS BYTE will be the only one of 
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interest to you, however. 


FORMAT DISK (Command Byte » *21 ) 

The Handler commands the diskette controller to format the entire 
diskette and then to verify it. All bad sector numbers (up to a 
maximum of 63) are returned and put in the supplied buffer* 
followed by two bytes of all 1 's (*FFFF). You set up the 
following DOB parameters prior to calling the Diskette Handler: 

COMMAND BYTE = *21. 

DEVICE NUMBER = disk drive number (l-4>. 

BUFFER ADDRESS * pointer to your 128-byte buffer. 

Upon return* you might be interested in the following DCB parameter 
STATUS BYTE = status of operation. 

BYTE COUNT = number of bytes of bad sector information in 
your buffer* not including the *FFFF terminator. If there 
are no bad sectors* the count will eq.ua! zero. 


Serial Bus I/O 


Input/Output to devices other than the keyboard* the screen, and 
the ATARI Computer controller port devices* must utilize the 
Serial I/O bus. This bus contains data* control* and clock lines 
to be used to allow the computer to communicate with external 
devices on this "da isy chained " bus. Every device on the bus has 
a unique identifier and will respond only when directly 
addressed. 

The resident system provides a Serial I/O Utility (SIO)* that 
provides a standardized high-level program interface to the bus. 
SIO is utilized by the resident Diskette* Printer* and Cassette 
handlers* and is intended to be used by nonresident handlers (see 
Section 9>* or by app 1 icat ions* as well. For a detailed 
description of the program/SIQ interface and for a detailed bus 
specification refer to Section 9. 
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6 INTERRUPT PROCESSING 


Section 6 describes system actions for the various interrupt 
causing events# defines the many RAM vectors and provides 
recommended procedures for dealing with interrupts. 

The 6502 microcomputer processes three general interrupt types: 
chip-reset# nonmaskable interrupts (NMI) and maskable interrupt 
(IRQ). The IRQ interrupt type can be enabled and disabled using 
the 6502 CLI and SEI instructions. The NMI type cannot be 
disabled at the processor level# but the NMI interrupts other 
than C SYSTEM. RESET 3 key can be disabled at the ANTIC chip. 


The system events that can cause interrupts are listed below: 
chip-reset - power-up 

NMI - Display list interrupt (unused by OS) 
vertical-b lank (50/60 Hz) 

CSYSTEM. RESET! key 

IRQ - Serial bus output ready 

Serial bus output complete 
Serial bus input ready 

Serial bus proceed line (unused by system) 

Serial bus interrupt line (unused by system) 

POKEY timers 1# 2 and 4 
Keyboard key 
t BREAK 3 key 

6502 BRK instruction (unused by OS) 


Figure 6-1 List of System-Interrupt Events 
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The chip-reset interrupt is vectored via location FFFC to E477* 
where a JMP vector to the power-up routine is located. All NMI 
interrupts are vectored via location FFFA to the NMI interrupt 
service routine at E7B4* and all IRQ interrupts are vectored 
via location FFFE to the IRQ interrupt service routine at E6F3* 
at that point the cause of the interrupt must be determined by 
a series of tests. For some of the events there are built in 
monitor actions and for other events the corresponding 
interrupts are disabled or ignored. The system provides RAM 
vectors so that you can intercept interrupts when 
necessary. 


CHIP-RESET 

The OS generates chip-reset in response to a power-up condition. 
The system is completely initialized (see Section 7). 


NONMASKABLE INTERRUPTS 

When an NMI interrupt occurs* control is transferred through 
the ROM vector directly to the system NMI interrupt service 
routine. A cause for the interrupt is determined by examining 
hardware register NMIST CD40F3. The NMI makes a jump through the 
global RAM vector VDSLST £02003 if a display list interrupt is 
pending. The OS does not use display list interrupts * so VDSLST 
is initialized to point to an RTI instruction* and you must not 
change it before VDSLST generates a display interrupt. 

If the interrupt is not a display-list interrupt* then a test is 
made to see if it is a CSYSTEM. RESET3 key interrupt. If so* then a 
jump is made to the system reset initiali zation routine (see Section 
7 for details of system reset in i t ial i zat ion > . 

If the interrupt is neither a display list interrupt nor a 
CSYSTEM. RESET 3 key interrupt* then it is assumed to be a 
vert ical-b lank (VBLANK) interrupt * and the following actions 
occur: 

Registers A* X and Y are pushed to the stack. 

The interrupt request is cleared (NMIRES CD40F3). 

A jump is made through the " immed iate" vertical-blank global 
RAM vector VVBLKI £02223 that normally points to the Stage 1 
VBLANK processor. 

The following actions occur assuming that you have not changed VVBLKI. 


OPERATING SYSTEM C016555 — Section 6 

103 



The stage 1 VBLANK processor is executed. 

The OS tests to see if a critical code section has been 
interrupted. If so; then all registers are restored/ and an 
RTI instruction returns from the interrupt to the critical 
section. A critical section is determined by examining the 
CRITIC flag C00423/ and the processor I bit. If either are 
set/ then the interrupted section is assumed to be critical. 

If the interrupt was not from a critical section/ then the 
stage 2 VBLANK processor is executed. 

The OS then jumps through the “deferred 1 ' ver tical-b lank 
global RAM vector VBLKD C02243/ that normally points to the 
VBLANK exit routine. 

The following actions occur assuming that you have not changed VVBLKD. 
o The 6502 A# X and Y registers are restored, 
o An RTI instruction is executed. 


NOTE: You can alter the deferred and immediate 

VBLANK RAM vectors/ but still enable normal system processes; or 
restore original vectors without having to save them. The 
instruction at E45F is a JMP to the stage 1 VBLANK processor; the 
address at CE460/ 23 is the value normally found in VVBLKI. The 
instruction at E462 is a VMP to the VBLANK exit routine; the 
address at EE463/ 23 is the value normally found in VVBLKD. These 
ROM vectors to stage 1 VBLANK processor and to the VBLANK exit 
routine will accomplish your goal. 

NOTE: Every VBLANK interrupt jumps through vector VVBLKI. Only 

VBLANK interrupts from noncritical code sections jump through 
vector VVBLKD. 


Stage 1 VBLANK Process 

The following stage 1 VBLANK processing is performed at every 
VBLANK interrupt: 

The stage 1 VBLANK process increments the 3-byte frame 
counter RTCLOK C 0012-00143 ; RTCLQK+O is the MSB and RTCLOK+2 
is the LSB. This counter wraps to zero when it overflows 
(every 77 hours or so)/ and continues counting. 

The Attract mode variables are processed (see Appendix Lz 
B 1 0— 12). 

The stage 1 VBLANK process decrements the System Timer 1 
CDTMV1 C0218/ 23 if it is nonzero; if the timer goes from 
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nonzero to zero then an indirect JSR is performed via CDTMA1 
£0226, 23. 


Stage 2 VBLANK Process 

The stage 2 VBLANK processing performs the following for those 
VBLANK interrupts that do not interrupt critical sections: 


The stage 2 VBLANK process clears the 6502 processor I bit. 
This enables the IRQ interrupts. 

The stage 2 VBLANK process updates various hardware 
registers with data from the OS data base# as shown below: 


Data Base 

Hardware 

Reason 

for Update 

I tern 


Register 



SDLSTH 

£0231 3 

DLISTH 

CD4033 

Display 

list start 

SDLSTL 

C 0230 3 

DLISTL 

CD4023 



SDMCTL 

C022F3 

DMACTL 

CD4003 



CHBAS 

C02F43 

CHBASE 

CD4093 



CHACT 

C02F33 

CHACTL 

CD4013 



GPRIOR 

C026F3 

PRIOR 

CD01B3 



COLORO 

C02C43 

COLPFO 

£ DO 163 

Attract 

mode. 

COLOR 1 

C02C53 

C0LPF1 

£D0173 



C0L0R2 

C02C63 

C0LPF2 

£D0183 



COLOR 3 

C02C73 

C0LPF3 

£D0193 



COLOR 4 

C02C83 

COLBK 

£D01 A3 



PCOLRO 

£02C03 

COLPMO 

£D0123 



PC0LR1 

C02C13 

C0LPM1 

CD0133 



PC0LR2 

£02C23 

C0LPM2 

£D0143 



PC0LR3 

C02C33 

C0LPM3 

£D01 53 



Constant = 8 

CONSOL 

£D01F3 

Console 

speaker off 

ie stage 

2 VBLANK 

process 

decrements the System Timer 


CDTMV2 £021A, 23 if it is nonzero; if the timer goes from 
nonzero to zero, then an indirect JSR is performed 
through CDTMA2 £0228,23. 

The stage 2 VBLAMK process decrements System Timers 3, 4 and 

5 if they are nonzero; the corresponding flags are set to 
zero for each timer that changes from nonzero to zero. 
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T imer 

Timer Value 

Timer Flag 


3 

CDTMV3 

C021C, 23 

CDTMF3 

E022A, 

13 

4 

CDTMV4 

C021E/ 23 

CDTMF4 

C022C/ 

13 

5 

CDTMV5 

CG220, 23 

CDTMF5 

C022E/ 

13 


A character is read from the POKEY keyboard register and 
stored in CH C02FC3# if auto repeat is active. 

The stage 2 VBLANK process decrements the keyboard debounce 
counter if it is not equal to zero* and if no key is 
pressed. 

The stage 2 VBLANK process processes the keyboard auto 
repeat (see Appendix L# E8). 

The stage 2 VBLANK process reads game controller data from 


e hardware to 

the RAM data base# 

as shown below: 

Hardware 

Data Base 

Func t ion 

Reg ister 

Item 



PORTA 

CD3003 

STICKO 

C 0278 3 

Joysticks and 



STICK1 

C 0279 3 




PTRIGO 

C027C3 

Paddle Controllers 



PTRIG1 

C027D3 




PTRIG2 

C027E3 




PTRIG3 

C027F3 


PORTB 

CD3013 

STICK2 

C 027 A 3 




STICK3 

C027B3 




PTRIG4 

C 0280 3 




PTRIG5 

C 028 1 3 




PTRIG6 

C 0282 3 




PTRIG7 

C 0283 3 


POT 0 

CD2003 

PADDLO 

C 0270 3 

Paddle Controllers 

POT 1 

CD2013 

PADDL1 

C02713 


POT 2 

CD2023 

PADDL2 

C 0272 3 


POT 3 

CD2033 

PADDL3 

C 0273 3 


POT 4 

CD2043 

PADDL4 

t 0274 3 


POT 5 

CD2053 

PADDL5 

C02753 


POT 6 

1 0206 3 

PADDL6 

C 0276 3 


POT 7 

CD2073 

PADDL7 

C 0277 3 


TRIGO 

CD0013 

STRIGO 

C 0284 3 

Joystick triggers. 

TRIG1 

CD0023 

STRIG1 

C 0285 3 

TRIG2 

ED0033 

STRIG2 

C 0286 3 


TRIG3 

CD0043 

STRIG3 

C 0287 3 
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MASKABLE INTERRUPTS 


An IRQ interrupt causes control to be transferred through the 
immediate IRQ global RAM vector VIMIRQ C02163. Ordinarily this 
vector points to the system IRQ Handler. The Handler performs 
these following actions: 

The IRQ Handler determines a cause for the interrupt by 
examining the IRQST CD20E3 register and the PIA status 
registers PACTL CD3023 and PBCTL CD3033. The interrupt status bit 
is cleared when it is found. One interrupt event is cleared and 
processed for each interrupt-service entry. If multiple IRQs are 
pending# then a separate interrupt will be generated for each 
pending IRQ# until all are serviced. 

The system IRQ interrupt service routine deals with each of the 
possible IRQ causing events# in the following ways: 

o The 6502 A register is pushed to the stack. 

o If the interrupt is due to serial I/O bus output ready# 
then clear the interrupt and jump through global RAM 
vector VSEROR C020C3. 

o If the interrupt is due to serial I/O bus input ready# 
then clear the interrupt and jump through global RAM 
vector VSERIN C020A3. 

o If the interrupt is due to serial I/O bus output 

complete# then clear the interrupt and jump through 
global RAM vector VSEROC C020E3. 

o If the interrupt is due to POKEY timer #1# then clear the 
interrupt and jump through global RAM vector VTIMR1 C02103. 

o If the interrupt is due to POKEY timer #2# then clear the 
interrupt and jump through global RAM vector VTIMR2 C02123. 

o If the interrupt is due to POKEY timer #4# then clear the 
interrupt. The service routine contains a bug# and falls 
into the following test. 

o If pressing a keyboard key caused the interrupt (other 

than C BREAK 3 # CSTART3# C0PTI0N3# or C SELECT 3 ) » then clear the 
interrupt and jump through global RAM vector VKEYBD C02083. 

o If pressing the CBREAK3 key caused the interrupt# then 

clear the interrupt. Set the BREAK flag BRKKEY C0Q113 to 
zero# proceed to clear the following: 

Start/stop flag SSFLAG C02FF3 
Cursor inhibit flag CRSINH C02F03 
Attract mode flag ATRACT C004D3 
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Return from the interrupt after restoring the 6502 A 
register from the stack. 

o If the interrupt is due to the serial I/O bus proceed line# 
then clear the interrupt# and jump through global RAM vector 
VPRCED £ 02021 . 

o If the interrupt is due to the serial I/O bus interrupt 

line# then clear the interrupt and jump through global RAM 
vector VINTER £02043. 

o If the interrupt is due to a 6502 BRK instruction# then jump 
through global RAM vector VBREAK £02063. 

o If none of the above, restore the 6502 A register and return 
from the interrupt (RTI). 


INTERRUPT INITIALIZATION 

The interrupt subsystem completely reinitializes itself whenever 
the system is powered up or the ESYSTEM. RESET3 key is pressed. 
The OS clears the hardware registers# and sets the interrupt 
global RAM vectors to the following configurations: 


Vector 


Type 

Function 

VDSLST 

£ 0200 3 

NMI 

RTI — ignore interrupt. 

VVBLKI 

E 0222 3 

«« 

System stage 1 VBLANK. 

CDTMA1 

£ 0226 3 

II 

SIO timeout timer. 

CDTMA2 

£ 0228 3 

If 

No system function. 

VVBLKD 

£ 0224 3 

« 

System return from interrupt 

VIMIRQ 

£02163 

IRQ 

System IRQ processor. 

VSEROR 

C020C3 

II 

SIO. 

VSERIN 

C 020 A 3 

II 

SIO. 

VSEROC 

£ 020E 3 

II 

SIO. 

VTIMR1 

£02103 

II 

PLA# RTI — ignore interrupt. 

VTIMR2 

£02123 

II 

PLA# RTI — ignore interrupt. 

VTIMR4 

C02143 

II 

*** doesn't matter *•** 

VKEYBD 

£02083 

II 

System keyboard 
interrupt handler. 

VPRCED 

£02023 

If 

PLA# RTI — ignore interrupt. 

VINTER 

£02043 

II 

PLA# RTI — ignore interrupt. 

VBREAK 

£02063 

BRK 

PLA# RTI — ignore interrupt. 


Figure 6-2 Interrupt RAM Vector Ini tial i zation 
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System ini t ial i zat ion sets the interrupt enable status 
as follows: 

NMI VBLANK enabled# display list disabled. 

IRQ £BREAK3 key and data key interrupts enabled# all others 
disabled. 


SYSTEM TIMERS 

The OS contains five general purpose software timers# plus an 
OS-supported frame counter. The timers are 2 bytes in length 
Clo#hi> and the frame counter RTCLOK £00123 is three bytes in 
length (hi# mid# la). The timers count downward from any 
nonzero value to zero. Upon reaching zero# they either clear 
an associated flag# or JSR through a RAM vector. The frame 
counter counts upward# wrapping to zero when it overflows. 

The following table shows the timers and the frame counter 
charac ter istics: 


Timer Name Flag/Vector Use 

* CDTMV1 C 02 183 CDTMA1 £02263 2-byte vector — SIO timeout. 
CDTMV2 £021 A3 CDTMA2 £02283 2-byte vector 

CDTMV3 £02103 CDTMF3 £022A3 1-byte flag 
CDTMV4 £02 IE 3 CDTMF4 £02203 1-byte flag 
CDTMV5 £02203 CDTMF5 £022E3 1-byte flag 

* RTCLOK £00123 3-byte frame counter. 


* These two timers are maintained as part of every VBLANK 

interrupt (stage 1 process). The other timers are subject to 
the critical section test (stage-2 process)# that can defer 
their updating to a later VBLANK interrupt. 


USAGE NOTES 

This subsection describes the techniques you need to know in 
order to utilize interrupts in conjunction with the operating 
system. 
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POKEY Interrupt Mask 


ANTIC < d isp lay-1 ist and vert ica 1-b lank ) and PIA (interrupt and 
proceed lines) interrupts can be masked directly (see the 
Hardware Manual). However, eight bits of a single byte IRGEN 
CD20E3 mask the POKEY interrupts (CBREAK3 key, data key, 
serial input ready, serial output ready, serial output done 
and timers 1,2 and 4). 

IRGEN is a write-only register. Thus, we must maintain a 
current value of that register in RAM in order to update 
individual mask bits selectively, while not changing other bits. 
The name of the variable used is POKMSK C00103, and it is used 
as shown in the examples below: 


; EXAMPLE OF 

INTERRUPT ENABLE 


SEI 


TO AVOID CONFLICT WITH IRQ 


LDA 

POKMSK 

... PROCESSOR WHICH ALTERS 

VAR 

ORA 

#*xx 

ENABLE BIT(S) . 


STA 

POKMSK 



STA 

IRGEN ; TO HARDWARE REG TOO. 


CLI 




; EXAMPLE OF 

INTERRUPT DISABLE 


SEI 


TO AVOID CONFLICT WITH IRG 


LDA 

POKMSK 

. . . PROCESSOR WHICH ALTERS 

VAR 

AND 

#*FF-xx 

DISABLE BIT(S) . 


STA 

POKMSK 



STA 

IRGEN 

TO HARDWARE REGISTER TOO. 


CLI 




Figure 6-3 POKEY 

Interrupt Mask Example 



Note that the OS IRQ service routine uses and alters POKMSK, so 
alterations to the variable must be done with interrupts 
inhibited. If done at the interrupt level there is no problem, as 
the I bit is already set; if done at a background level then the 
SEI and CLI instructions should be used as shown in the examples. 


Setting Interrupt and Timer Vectors 

Because vertical-blank interrupts are generally kept enabled so that 
the frame counter RTCLOK is maintained accurately, there is a 
problem with setting the VBLANK vectors (VVBLKI and VVBLKD) or 
the timer values (CDTMV1 through CDTMV5) directly. A VBLANK 
interrupt could occur when only one byte of the two-byte value had 
been updated, leading to undesired consequences. For this reason, 
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the SETVBV CE45F3 routine is provided to perform the desired 
update in safe manner. The calling sequence is shown below: 


A = update item indicator 
1-5 for timers 1-5. 

6 for immediate VBLANK vector VVBLKI. 

7 for deferred VBLANK vector VVBLKD. 

X = MSB of value to store. 

Y = LSB of value to store. 

JSR SETVBV 

The A* X and Y registers can be altered. 

The display list interrupt will always be disabled on 
return* even if enabled upon entry. 

It is possible to fully process a ver t ica 1-b lank interrupt 
during a call to this routine. 

When working with the System Timers* the vectors for timers 1 and 
2 and the flags for timers 3*4 and 5 should be set while the 
associated timer is equal to zero* then the timer should be set 
to its (nonzero) value. 


Stack Content at Interrupt Vector Points 

The following table shows the stack content at every one of the 
RAM interrupt vector points: 
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RAM STACK CONTENT 

INTERRUPT VECTOR DESCRIPTION OS RETURN CONTROL 


VDSLST 

£0200 3 


Display list 

return/ 

P 




VVBLKI 

C 0222 3 

* 

VBLANK immediate 

return/ 

P/ 

A, 

X/ 

Y 

CDTMA1 

£02263 


System Timer 1 

return/ 

P/ 

A, 

X, 

Y, 

CDTMA2 

£02283 


System Timer 2 

return/ 

P/ 

A/ 

X/ 

Y, 

VVBLKD 

£02243 

* 

VBLANK defer. 

return/ 

Pz 

A, 

X/ 

Y 

VIMIRQ 

£02163 

* 

IRQ immediate 

return/ 

P/ 

A 



VSEROR 

C020C3 

* 

Serial out ready 

return/ 

P/ 

A 



VSERIN 

£ 020 A 3 

* 

Serial in ready 

return/ 

Pz 

A 



VSEROC 

C020E3 

* 

Serial out compare 

return/ 

P/ 

A 



VTIMR1 

£02103 


POKEY timer 1 

return/ 

P/ 

A 



VTIMR2 

£02123 


POKEY timer 2 

return/ 

P/ 

A 



VTIMR4 

C02143 


POKEY timer 4 

return/ 

P/ 

A 



VKEYBD 

£02083 

* 

Keyboard data 

return/ 

P, 

A 



VPRSED 

£02023 


Serial proceed 

return/ 

P/ 

A 



VINTER 

C 0204 3 


Serial interrupt 

return/ 

P/ 

A 



VBREAK 

£02063 


BRK instruction 

return/ 

P/ 

A 



Figure 6-4 

Interrupt 

and Timer Vector RAM 

Stack Content 

Table 


return 

return 


* The OS initializes these entries at power-up. Improperly 
changing these vectors will alter system performance. 


Miscel laneous Cons iderations 

The following paragraphs list a set of miscellaneous 
considerations for the writer of an interrupt service routine. 


Restrictions on Clearing of "I” Bit 

Display list/ immediate vert ica 1-b lank and System Timer #1 
routines should not clear the 6502 I bit. If the NMI leading to 
one of these routines occurred while an IRQ was being processed/ 
then clearing the I bit will cause the IRQ to re-interrupt with 
an unknown result. 

The OS VBLANK processor carefully checks this condition after the 
stage 1 process and before the stage 2 process. 


Interrupt Process Time Restrictions 

You should not write an interrupt routine that exceeds 400 msec, 
when added to the stage 1 VBLANK/ if the serial I/O is being 
used. The SIO sets the CRITIC flag while serial bus I/O is in 
progress. 
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Interrupt Delay Due to "WAIT FOR SYNC" 

Whenever a key is read from the keyboard* the Keyboard Handler 
sets WSYNC CD40A3 repeatedly while generating the audible click 
on the console speaker. A problem occurs when interrupts are 
generated during the wa i t-f or-sy nc period; the processing of such 
interrupts will be delayed by one horizontal scan line. This 
condition cannot be prevented. You can work around the condition 
by examining the line count VCOUNT CD40B3 and delaying interrupt 
processing by one line when no WSYNC delay has occurred. 

FLOWCHARTS 

The following pages contain process flowcharts showing the main 
events that occur in the NMI and IRQ interrupt processes. 
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7 SYSTEM INITIALIZATION 


Section 7 discusses the details of the power-up and 
system reset processes. The power-up process will be explained 
first* and then the system reset process will be explained in 
terms of its differences from the power-up process. 

Both power-up (also called coldstart) and pressing t SYSTEM. RESET! 
(warmstart) will cause system ini t ial i za tion: In addition* there 
are vectors for these processes at E474 (system reset) and E477 
(power-up) so that they can be user-init iated. 


The power-up in i t ia 1 i zat i on process is a superset of the 
system reset ini tial i zation process. Power-up initializes both 
the OS and user RAM regions* whereas system reset initializes 
only the OS RAM region. In both cases, the OS calls the outer 
level software ini t ial i zation entry points allow the application 
to initialize its own variables. 

Pressing the C SYSTEM. RESET! key produces an NMI interrupt. It 
does not perform a 6502 chip-reset. If the processor is locked 
up* the CSYSTEM. RESET! key cannot be sufficient to unlock it, and the 
system must have power cycled to clear the problem. 


POWER-UP INITIALIZATION (COLDSTART) PROCEDURE 

The OS performs the following functions in the order shown* as 
part of the power-up initial i zat ion process: 

1. The fallowing 6502 processor states are set: 

o IRQ interrupts are disabled using the SEI instruction. 

o The decimal flag is cleared using the CLD instruction. 

o The stack pointer is set to $FF. 


2. The OS sets the warmstart flag WARMST E0008! to 0 (false). 
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3. The OS tests to see if a diagnostic cartridge is in the A slot: 
o Cartridge address BFFC = 00? 

o The memory at BFFC is not RAM? 

o Bit 7 of the byte at BFFD * i? 


If all of the above tests are true# then control is passed to 
the diagnostic cartridge via the vector at BFFE. No return is 
expected. 


4. The OS determines the lou/est memory address containing 

non-RAM# by testing the first byte of every 4K “block" to see 
if the content can be complemented. If it can be complemented# 
then the original value is restored and testing continues. If 
it can't be complemented# then the content is assumed to be 
the first non-RAM address in the system. The MSB of the 
address is stored temporarily in TRAMSZ C00063. 


5. Zero is stored to all of the hardware register addresses shown 
below (most of that aren't decoded by the hardware): 

DOOO through DOFF 
D200 through D2FF 
D300 through D3FF 
D400 through D4FF 

6. The OS clears RAM from location 0008# to the address 
determined in step 4# above. 

7. The default value for the “noncartridge" control vector 
DOSVEC C000A3 is set to point to the blackboard routine. At 
the end of initial i zat ion# control is passed through this 
vector if a cartridge does not take control. 

8. The coldstart flag COLDST C02443 is set to -1 (local use). 

9. The screen margins are set: left margin = 2# right margin = 

39# for a 38 character physical line. The maximum line size of 
40 characters can be obtained by setting the margins to 0 and 
39. The OS insets the left margin because the two leftmost 
columns of the video picture on many television sets are not 
entirely visible on the screen. 

10. The interrupt RAM vectors VDSLST C02003 through WBLKD C02243 
are initialized. See Section 6 for the ini t ial i zat ion values. 

11. Portions of the OS RAM are set to their required nonzero values 
as shown below: 
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o 


The C BREAK 3 key flag BRKKEY C00113 = -1 (false). 


o The top of memory pointer MEMTOP C02E53 * the lowest 

non-RAM address (from step 4); MEMTOP will be altered 
later when the Screen Editor is opened in step 15. 

o The bottom of memory pointer MEMLO C02E73 * 0700; MEMLO 

can be changed later if there is either a diskette- or 
cassette-boot operation. 

o The following resident routines are called for initial i zat ion: 

Screen Editor 
Display Handler 
Keyboard Handler 
Printer Handler 
Cassette Handler 
Central I/O Monitor (CIO) 

Serial I/O Monitor (SIO) 

Interrupt processor 

o The CSTART3 key is checked* and if pressed* the cassette-boot 

request flag CKEY C004A3 is set. 

12. 6502 IRQ interrupts are enabled using the CLI instruction. 

13. The device table HATABS C031A3 is initialized to point to the 
resident handlers. See Section 9 for information relating to 
the Device Handler table. 

14. The cartridge slot addresses for cartridges B and A are 
examined to determine if cartridges are inserted* if RAM does 
not extend into the cartridge address space. 

If the content of location 9FFC is zero* then a JSR is 
executed through the vector at 9 FFE* thus initializing 
cartridge “B". The cartridge is expected to return. 

If the content of location BFFC is zero* then a JSR is 
executed through the vector at BFFE* thus initializing 
cartridge ,, A“. The cartridge is expected to return. 

15. IOCB #0 is set up for an OPEN of the Screen Editor (E) and 
the OPEN is performed. The Screen Editor will use the highest 
portion of RAM for the screen and will adjust MEMTOP 
accordingly. If this operation should fail* the entire 
initial i zation process is repeated. 

16. A delay is effected to assure that a VBLANK interrupt has 
occurred. This is done so that the screen will be established 
before continuing. 

17. If the cassette-boot request flag is set (see step 11 above)* 
then a cassette-boot operation is attempted. See Section 10 
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for details of the cassette-boot operation. 

18. If any of the three conditions stated below exists* an 
attempt is made to boot from the disk. 

There are no cartridges in the slots. 

Cartridge B is inserted and bit 0 of 9FFD is 1. 

Cartridge A is inserted and bit 0 of BFFD is 1. 

See Section 10 for details of the diskette-boot operation. 

19. The coldstart flag COLDST is reset to indicate that the 
coldstart process went to completion. 

20. The in i t ia 1 i zat i on process is now complete* and the 
controlling application is now determined via the remaining 
steps. 

If there is an A cartridge inserted and bit-2 of BFFD is 1* 
then a JMP is executed through the vector at BFFA. 

Or* if there is a B cartridge inserted and bit-2 of 9FFD is 
1* then a JMP is executed through the vector at 9FFA. 

Or* a jump is executed through the vector DOSVEC that can 
point to the blackboard routine (default case)* cassette 
booted software or diskette booted software. DOSVEC can be 
altered by the booted software as explained in Section 10. 


SYSTEM RESET INITIALIZATION (WARMSTART) PROCEDURE 

The functions listed below are performed* in the order shown* as 

part of the system reset init ial i zation process: 

A. Same as power-up step 1. 

B. The warmstart flag WARMST C00083 is set to -1 (true). 

C. Same as power-up steps 3 through 5. 

D. OS RAM is zeroed from locations 0200-03FF and 0010-007F. 

E. Same as power-up steps 9 through 16. 

F. If a cassette-boot was successfully completed during the 
power-up ini tial i zation* then a JSR is executed through the 
vector CASINI C00023. See Section 10 for details of the 
cassette-boot process. 
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G. Same as power-up step 18/ except instead of booting the 
diskette software/ a JSR is executed through the vector DOSINI 
COOOC3 if the diskette-boot was successfully completed during the 
Power-up ini tial i zation. See Section 10 for details of the 
diskette-boot process. 

H. Same as power-up steps 19 and 20. 

Note that the ini tial ization procedures and main entries for all 
software entities are executed at every system reset as well as 
at power up (see steps 14/ 17 , 18/ 20/ F and G>. If the 

user-supplied ini t ial ization/startup code must behave differently 
in response to system reset than it does to power-up/ then the 
warmstart flag WARMST C00083 should be interrogated; WARMS! = 0 
means power-up entry/ else system reset entry. 
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8 FLOATING POINT ARITHMETIC PACKAGE 


This section describes the BCD floating point (FP) package that 
is resident in the OS ROM in both the models 400 and 800. 


The floating point package maintains numbers internally as 6-byte 
quantities: a 5-byte <10 BCD digit) mantissa with a 1-byte 
exponent. BCD internal representat ion was chosen so that decimal 
division would not lead to the rounding errors typically found in 
binary representation implementations. 


The package provides the following operations: 

ASCII to FP conversion. 

FP to ASCII conversion. 

Integer to FP conversion. 

FP to integer conversion. 

FP add/ subtract/ multiply/and divide. 

FP logarithm/ exponentiation/ and polynomial evaluation. 
FP zero, load# store/ and move. 

A floating point operation is performed by calling one of the 
provided routines (each at a fixed address in ROM) after having 
set one or more floating point pseudo registers in RAM. The 
result of the desired operation will also involve floating point 
pseudo registers. The primary pseudo registers are described 
below and their addresses given within the square brackets: 
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FRO COOD43 = 6-byte internal form of FP number. 

FR1 C00E03 » 6-byte internal form of FP number. 

FLPTR COOFC3 = 2-byte pointer <lo, hi) to a FP. 

numb er . 

INBUFF COOF33 = 2-byte pointer <lo, hi) to an ASCII text 

buffer. 

CIX COOF23 = 1-byte index, used as offset to buffer 

pointed to by INBUFF. 

LBUFF C 0580 3 ■ result buffer for the FASC routine. 


FUNCTIONS/CALLING SEQUENCES 

Descriptions of these floating point routines assume that 
a pseudo register is not altered by a given routine. The 
numbers in square brackets Cxxxx3 are the ROM addresses of the 
routines. 


ASCII to Floating Point Conversion (AFP) 

Function: This routine takes an ASCII string as input and 
produces a floating point number in internal form. 

Calling sequence: 

INBUFF = pointer to buffer containing the ASCII 
representation of the number. 

CIX = the buffer offset to the first byte of the ASCII 
number. 

JSR AFP CD8003 

BCS first byte of ASCII number is invalid 

FRO = floating point number. 

CIX = the buffer offset to the first byte after the ASCII 
number. 

Algorithm: The routine takes bytes from the buffer until it 
encounters a byte that cannot be part of the number. The bytes 
scanned to that point are then converted to a floating point 
number. If the first byte encountered is invalid, the carry bit 
is set as a flag. 


Floating Point to ASCII Conversion (FASC) 

Function: This routine converts a floating point number from 
internal form to its ASCII representation. 
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Calling sequence: 


FRO = floating point number. 

JSR FASC CD8E63 

INBUFF ■ pointer to the first byte of the ASCII number. 

The last byte of the ASCII representation has the most 
significant bit (sign bit) set; no EOL follows. 

Algorithm: The routine converts the number from its internal 
floating point representation to a printable form (ATASCII). The 
pointer INBUFF will point to part of LBUFF# where the result is 
stored. 


Integer to Floating Point Conversion ( IFP > 

Function: This routine converts a 2-byte unsigned integer (O to 
65535) to floating point internal repr esenta t ion. 

Calling sequence: 

FRO - integer (FRO+O * LSB# FRO+1 = MSB). 

JSR IFP CD9AA3 

FRO = floating point representation of integer. 


Floating Point to Integer Conversion (FPI) 

Function: This routine converts a positive floating point number 
from its internal representation to the nearest 2-byte integer. 

Calling sequence: 


FRO = floating point number. 

JSR FPI CD9D23 

BCS FP number is negative or >= 65535. 5 


FRO = 2-byte integer (FRO+O = LSB# FRO+1 * MSB). 

Algorithm: The routine performs true rounding# not truncation# 
during the conversion process. 
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Floating Point Addition (FADD) 

Function: This routine adds two floating point numbers and checks 
the result for ou t-of-range. 

Calling sequence: 

FRO * floating point number. 

FR1 = floating point number. 

JSR FADD CDA663 

BCS out-of -range result. 

FRO * result of FRO + FR1. 

FR1 is altered. 


Floating Point Subtraction (FSUB) 

Function: This routine subtracts two floating point numbers and 
checks the result for out-of-range. 

Calling sequence: 

FRO = floating point minuend. 

FR1 = floating point subtrahend. 

JSR FSUB CDA603 

BCS out-of-range result. 

FRO = result of FRO - FR1. 

FR1 is altered. 


Floating Point Mul tipi ication (FMUL) 

Function: This routine multiplies two floating point numbers and 
checks the result for out-of -range. 

Calling sequence: 

FRO = floating point multiplier. 

FR1 ■ floating point mul tip 1 icand. 

JSR FMUL CDADB3 

BCS out-of-range result. 

FRO « result of FRO * FR1. 

FR1 is altered. 
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Floating Point Division <FDIV> 


Function: This routine divides two -floating point numbers and 
checks for division by zero and for result out-of -range. 

Calling sequence: 

FRO = floating point dividend. 

FR1 = floating point divisor. 

JSR FDIV CDB283 

BCS out-of-range result or divisor is zero. 

FRO * result of FRO / FR1 . 

FR1 is altered. 


Floating Point Logarithms (LOO and L0G10) 

Function: These routines take the natural or base 10 logarithms 
of a floating point number. 

Calling sequence: 

FRO * floating point number. 

JSR LOO CDECD3 for natural logarithm 

or 

JSR L0010 CDED1 1 for base 10 logarithm 

BCS negative number or overflow. 

FRO = floating point logarithm. 

FR1 is altered. 

Algorithm: Both logarithms are first computed as base 10 
logarithms using a 10 term polynomial approx imation; the natural 
logarithm is computed by dividing the base 10 result by the 
constant LOOlO(e). 

The logarithm of a number Z is computed as follows: 

F -a- <10 ** Y) = Z where 1 O F < 10 (normal i zation ) . 

L = LOOIO(F) by 10 term polynomial approx imat ion. 

LOOIO(Z) = Y + L. LOO(Z> = L0010(Z> / LOOlO(e). 

NOTE: This routine does not return an error if the number input 
is zero; the L0010 result in this case is approx imately -129.5, 
which is not useful. 
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Floating Point Exponentiation (EXP and EXP10) 
Function: This routine exponentiates. 

Calling sequence: 

FRO = floating point exponent (Z). 


JSR 

EXP CDDC03 for e 

Z 

JSR 

EXP10 CDDCC3 for 

10 ** Z 

BCS 

overflow. 



FRO « floating point result. 
FR1 is altered. 


Algorithm: Both exponentials are computed internally as base 10/ 
with the base e exponential using the identity: 
e ** X * 10 **• ( X * LOO 10(e) ). 

The base 10 exponential is evaluated in two parts using the identity: 

10 ** X * 10 ** (I + F> * (10 ** I) * (10 ** F) — where I is the 
integer portion of X and F is the fraction. 

The term 10 ** F is evaluated using a polynomial approx imat ion/ 
and 10 I is a stra igh tf orward modification to the floating 
point exponent. 


Floating Point Polynomial Evaluation (PLYEVL) 

Function: This routine performs an n degree polynomial 
evaluat ion. 

Calling sequence: 

X/ Y = pointer (X = LSB ) to list of FP coefficients (A(i)> 
ordered from high order to low order (six bytes per 
coefficient) . 

A = number of coefficients in list. 

FRO = floating point independent variable (Z). 

JSR PLYEVL CDD403 

BCS overflow or other error. 

FRO * result of A(n)*Z**n + A(n-i >*Z**n-l ... + A(1)*Z + 
A(0) . 

FR1 is altered. 

Algorithm: The polynomial P(Z> = SUM(i=0 to n> ( A( i >*Z**i > is 
computed using the standard method shown below: 

P(Z> ® (. . . (A(n)*Z + A(n-l))*Z + . . . + A( 1 ) >*Z + A(0> 
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Clear FRO (ZFRO) 


Function: This routine sets the contents of pseudo register FRO 
to all zeros. 

Calling sequence: 

JSR ZFRO CDA443 

FRO = zero. 


Clear Page Zero Floating Point Number (ZF1) 

Function: This routine sets the contents of a zero-page floating 
point number to all zeroes. 

Calling sequence: 

X = Zero-page address of FP number to clear. 

JSR ZF1 CDA463 

Zero-page FP number(X) = zero. 


Load Floating Point Number to FRO (FLOOR and FLDOP ) 

Function: These routines load pseudo register FRO with the 
floating point number specified by the calling sequence. 

Calling sequences: 

X/ Y = pointer (X = LSB) to FP number. 

JSR FLOOR C 0089 3 


or 


FLPTR * pointer to FP number. 

JSR FLDOP C 0080 3 

FRO » floating point number (in either case). 
FLPTR » pointer to FP number (in either case). 
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Load Floating Point Number to FR1 <FLD1R and FLD1P) 


Function: These routines load pseudo register FR1 with the 
floating point number specified by the calling sequence. 

Calling sequences: 

As in prior description# except the result goes to FR1 
instead of FRO. FLD1R CDD983 and FLD1P CDD9C3. 


Store Floating Point Number From FRO (FSTOR and FSTOP) 

Function: These routines store the contents of pseudo register 
FRO to the address specified by the calling sequence: 

Calling sequence: 

As in prior descriptions# except the floating point number 
is stored from FRO rather than loaded to FRO. FSTOR CDDA73 
and FSTOP EDDAB3. 


Move Floating Point Number From FRO to FR1 (FMOVE) 

Function: This routine moves the floating point number in FRO to 
pseudo register FR1. 

Calling sequence: 

JSR FMOVE CDDB63 

FR1 - FRO (FRO remains unchanged). 


RESOURCE UTILIZATION 

The floating point package uses the following RAM locations in 
the course of performing the functions described in this section 

00D4 through 00 FF 
057E through 05FF 

All of these locations are available for program coding 
if your program does not call the floating point package. 
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IMPLEMENTATION DETAILS 


Floating point numbers are maintained internally as 6-byte 
quantities* with 5 bytes (10 BCD digits) of mantissa and 1 byte 
of exponent. The mantissa is always normalized such that the 
most significant byte is nonzero (note "byte" and not "BCD 
digit"). 

The most significant bit of the exponent byte provides the sign 
for the mantissa; O for positive and 1 for negative. The 
remaining 7 bits of the exponent byte provide the exponent in 
excess 64 notation. The resulting number represents powers of 100 
decimal (not powers of 10). This storage format allows the 
mantissa to hold 10 BCD digits when the value of the exponent is 
an even power of 10* and 9 BCD digits when the value of the 
exponent is an odd power of 10. 

The implied decimal point is always to the immediate right of the 
first byte. An exponent less than 64 indicates a number less than 
1. An exponent equal to or greater than 64 represents a number 
equal to or greater than 1. 

Zero is represented by a zero mantissa and a zero exponent. To 
test for a result from any of the standard routines; test either 
the exponent or the first mantissa byte for zero. 

The absolute value of floating point numbers must be greater than 
10**-98* and less than 10**+98* or be equal to zero. There is 
perfect symmetry between positive and negative numbers with the 
exception that negative zero is never generated. 

The precision of all computations is maintained at 9 or 10 
decimal digits* but accuracy is somewhat less for those functions 
involving polynomial approximations (logarithm and 
exponent iat ion ) . Also* the problems inherent in all floating 
point systems are present here* for example: subtracting two very 
nearly equal numbers* adding numbers of disparate magnitude* or 
successions of any operat i on* will all result in a loss of 
significant digits. An analysis of the data range and the order 
of evaluation of expressions may be required for some types of 
applications. 

The examples below compare floating point numbers with their 
internal representations* as an aid to under s tand ing storage 
format. All numbers prior to this point have been expressed in 
decimal notation* but these examples will use hexadecimal 
notation. Note that 64 decimal (the excess number of the 
exponent) is 40 when expressed in hexadecimal: 


Number : 

+0. 02 

= 2 * 

10**-2 == 2 

* 100**-! 

Stored : 

3F 02 

00 00 

00 00 (FP 

exponent = 40 - 1 > 

Number: 

-0. 02 

= -2 * 

IQ**- 2 = - 

-2 * 100**-! 

Stored : 

BF 02 

00 00 

00 00 (FP 

exponent =80+40 
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Number: +37.0 * 3. 7 * 10**1 = 37 * 100**0 
Stored: 40 37 00 00 00 00 (FP exponent =40+0) 

Number: -4.60312486 * 10**11 = -46.03... * 100**5 
Stored: C5 46 03 01 24 86 (FP exponent =80+40+5) 

Number: 0. 0 

Stored: 00 00 00 00 00 00 (special case) 
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9 ADDING NEW DEVICE HANDLERS/PERIPHERALS 


This section describes the interface requirements for a 
nonresident Device Handler that is to be accessed via the Central 
I/O utility (CIO). The Serial bus I/O utility (SIO> interface is 
defined for those handlers that utilize the Serial I/O bus. 

The I/O subsystem is organized with three levels of software 
between you and your hardware: The CIO# the individual device 
handlers# and the SIO. 

The CIO performs the following functions: 

Logical device name to Device Handler mapping (on OPEN). 

I/O Control Block (IOCB) maintenance. 

Logical record handling. 

User buffer handling. 

The device handlers are below CIO. They perform the 
following functions: 

Device initial i zat ion on power-up and system reset. 
Device-dependent support of OPEN and CLOSE commands. 

By te-at-a-t ime data input and output. 

Device-dependent special operations. 

Device-dependent command support. 

Device data buffer management. 

The SIO is at the bottom level (for Serial I/O bus peripheral 
handlers). It performs the following functions: 

Control of all Serial bus I/O# conforming to the bus 
protocol. 

Bus operation retries on errors. 

Return of unified error statuses on error conditions. 
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A separate control structure is used for communicat ion at each 
interface, as follows: 

User/CIO I/O Control Block (IOCB) 

C IO/Hand ler Zero-page IOCB <ZIOCB> 

Hand ler /SIO Device Control Block (DCB ) 
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Where: shou/s a control path. 

**■#•* shows the data structure required for a path. 

Note the following: 

1. The Key board/Di sp lay /Screen Editor handlers don't use 
SIO. 

2. The Diskette Handler cannot be called directly from CIO. 

3. The DCB is shown twice in the diagram. 

Figure 9-1 I/O Subsystem Flow Diagram 
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DEVICE TABLE 


The device table is a RAM-resident table that contains the 

sing le-charac ter device name (e. g. K/ D/ C> etc), and the 

handler address for each of the handlers known to CIO. The 

table is initialized to contain entries for the following 

resident handlers: Keyboard <K># Display (S )/ Screen Editor 

(E)/ Cassette (C>/ and Printer <P> at power-up and system reset. To 

install a new handler/ some procedure must insert a device table entry 

after the table is initialized. 

The table format is shown below: 


+ + -4 

HATABS C031A3 ! device name ! 1 

+ + ; 

I handler vector I +- one entry 
+ + { 

! table address 1 ! 

+ 4. -4 

{ more ! 

I entries I 

4 4 

* zero fill to { 

S end of table ! 

4 4 


Figure 9-2 Device Table Format 


This 38-byte table will hold a maximum of 12 entries/ with the 
last 2 bytes being zero. CIO scans the table from the end to 
the beginning (high to low address)/ so the entry nearest the 
end of the table will take precedence in case of multiple 
occurrences of a device name. . 

The device name for each entry is a single ATASCII character/ and 
the handler address points to the handler's vector table/ that 
will be described in the following section. 


CIO/HANDLER INTERFACE 

This section describes the interface between the Central I/O 
utility and the individual device handlers that are represented 
in the Device Table (as described in the preceding section). 
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Calling Mechanism 

Each handler has a vector table as shown belour: 


+ + 

+ OPEN vector + 

4. — — — . — * — — — — — — — 4. 

+ CLOSE vector + 
■+• — — • — — — — — — — • + 

+ GETBYTE vector + 

+ + 

+ PUTBYTE vector + 

+ 4. 

+ GETSTAT vector + 

+ 4. 

+ SPECIAL vector + 

4. 4. 

+ JMP init code + 

4. 4. 

4. 4. 


(low address) 


(high address) 


Figure 9-3 Handler Vector Table 

The device table entry for the handler points to the first 
byte of the vector table. 

The first six entries in the table are vectors (lo/hi) that 
contain the address - 1 of the handler routine that handles 
the indicated function. The seventh entry is a 6502 JMP 
instruction to the handler ini tial i zat ion routine. CIO uses 
only the addresses contained in this table for handler entry. 
Each user/CIO command translates to one or more calls to one 
of the handler entries defined in the vector table. 

The vector table provides the handler addresses for certain 
fixed functions to be performed to CIO. In addition# operation 
parameters also must be passed for most functions. Parameter 
passing is accomplished using the 6502 A# X# and Y registers 
and an IOCB in page O named ZIOCB C00203. In general# register 
A is used to pass data# register X contains the index to the 
originating IOCB# and register Y is used to pass status 
information to CIO. The zero-page IOCB# is a copy of the 
originating IOCB# but in the course of processing some 
commands# CIO can alter the buffer address and buffer length 
parameters in ZIOCB# but not in the originating IOCB (see 
Section 5 for information relating to the originating IOCB). 

See Appendix B for the standard status byte values to be 
returned to CIO in register Y. 
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The following sections describe the ClO/handler interface for 
each of the vectors in the handler vector table. 


Handler In i t ial i zat ion 

NOTE: This entry doesn't appear to have any function for 

nonresident handlers due to a bug in the current OS — the 
device table is cleared in response to system reset as 
well as power-up. This prevents this entry point from ever 
being called. The rest of this section discusses the 
intended use of this entry point. Conformation would be in 
order to allow compatibility with possible corrected 
versions of the OS in the future. 


The entry was to have been call 
power-up and system reset; the 
initial i zation of its hardware 
that assures proper processing 


ed on all oc 
handler is t 
and RAM data 
of all CIO c 


currences of 
o perform 
using a routine 
ommands that follow. 


Functions Supported 

This section describes the functions assoc 
six vectors from the handler vector table, 
presents a brief# device-independent descr 
ClO/handler interface and recommended acti 
vector. 


iated with the first 
This section also 
iption of the 
ons for each function 


OPEN 


This entry is called in response to an OPEN command to CIO. The 
handler is expected to validate the OPEN parameters and perform 
any required device initial i zat ion associated with a device OPEN. 

At handler entry# the following parameters can be of interest: 

X - index to originating IOCB. 

Y « $92 (status = function not implemented by handler). 


ICDNOZ C0021 3 
ICBALZ/ICBAHZ 
ICAX1 Z/ ICAX2Z 


- device number <1-4# for multiple device 
handlers ) . 

C0024/00253 = address of device/f i lename 
spec if ication. 

C002A/002B3 = d evi c e-sp ec i f i c information. 


The hand 
ind icate 
reg i s ter 


ttempts to 
status of 
respons ib 


ler a 
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. The 


perform the indicated OPEN and 
the operation by the value of the Y 
ility for checking for multiple OPENs 


to 
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the same device or filer where it is illegal/ lies with the 
handler. 


CLOSE 

This vector table entry is called in response to a CLOSE command 
to CIO. The handler is expected to release any held resources 
that relate specifically to that device/f i lename, and for output 
files to: 

1) send any data remaining in handler buffers to the device# 

2) mark the end of file 

3) update any associated directoriesr allocation maps# etc. 


At handler entry# the following parameters can be of interest: 
X = index to originating IOCB. 

Y = $92 (status = function not implemented by handler). 

ICDNOZ £00213 = device number <1-4# for multiple device 

handlers) . 

ICAX1Z/ICAX2Z C002A/002B3 = device-spec if ic information. 

The handler attempts to perform the indicated CLOSE and 
indicates the status of the operation by the value of the Y 
register. 

CIO releases the associated IOCB after the handler returns# 
regardless of the operation status value. 


GETBYTE 

This vector table entry is called in response to a GET 
CHARACTERS or GET RECORD command to CIO. The handler is 
expected to return a single byte in the A register# or return an 
error status in the Y register. 

At handler entry# the following parameters can be of interest: 

X = index to originating IOCB. 

Y = $92 (status = function not implemented by handler). 

ICDNOZ £00213 = device number (1-4# for multiple device handlers). 
ICAX1Z/ICAX2Z £002A/002B3 = device-specific information. 

The handler will obtain a data byte directly from the device or from a 
handler-maintained buffer and return to CIO with the byte in the 
A register and the operation status in the Y register. 
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Handlers that do not have short timeouts associated with the 
reading of data (such as the Keyboard and Cassette Handlers)* 
must monitor the C BREAK 3 key flag BRKKEY C00113 and return with a 
status of $80 when a CBREAK3 condition occurs. See Appendix L* 

E5* and Section 12 for a discussion of CBREAK3 key monitoring. 

CIO checks for reads from device/files that have not been opened 
or have been opened for output only; the handler will not be called in 
those cases. 


PUTBYTE 

This entry is called in response to a PUT CHARACTERS or PUT 
RECORD command to CIO. The handler is expected to accept a single 
byte in the A register or return an error status in the Y 
register. 

At handler entry* the following parameters can be of interest: 

X = index to originating I0CB. 

Y = $92 (status = function not implemented by handler). 

A = data byte. 

ICDNOZ C00213 = device number (1-4* for multiple device 

handlers ) . 

ICAX1Z/ICAX2Z C002A/002B3 = device-spec if ic information. 

The handler sends the data byte directly to the device* or to a 
hand ler-maintained buffer* and returns to CIO with the operation 
status in the Y register. If a hand ler-maintained buffer fills* 
the handler will send the buffered data to the device before 
returning to CIO. 

CIO checks for WRITES to device/files that have not been opened* 
or have been opened for input only. The handler will not be called in 
those cases. 

Now that the normal operation of PUTBYTE has been defined* a 
special case must be added. Any handler that will operate within 
the environment of the ATARI 8K BASIC language interpreter has a 
different set of rules. Because BASIC can call the handler 
PUTBYTE entry directly, without going through CIO* the zero-page 
IOCB (ZIOCB) can or may not have a relation to the PUTBYTE call. 
Therefore* the handler must use the outer level IOCB to obtain 
any information that would normally be obtained from ZIOCB. Note 
also that the OPEN protection normally provided by CIO is 
bypassed (i.e. PUTBYTE to a non-OPEN device/file and PUTBYTE to a 
read-only OPEN). 
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GETSTAT 


This entry is called in response to a GET STATUS command to CIO. 

The handler is expected to return four bytes of status to memory 
or return an error status in the Y register. 

At handler entry/ the following parameters can be of interest: 

X * index to originating IOCB. Y = $92 (status « function not 
implemented by handler). 

ICDNOZ E00213 * device number (1-4/ for multiple device handlers). 

ICBALZ/ICBAHZ C0024/G0253 » address of 
device/filename specification. 

ICAX1Z/ICAX2Z 

C002A/002B3 = device-spec if ic information. 

The handler gets device status information from the device 
controller and puts the status bytes in DVSTAT C02EA3 through 
DVSTAT+3, and finally returns to CIO with the operation status 
in register Y. 

The IOCB need not be opened nor closed in order for you 
to request CIO to perform a GET STATUS operation/ the handler 
must check where there are restrictions. See Section 5 for a 
discussion of the CIO actions involved with a GET STATUS 
operation using both open and closed IGCB's/ and note the impact 
of this operation on the use of the buffer address parameter. 


SPECIAL 

This handler entry is used to support all functions not handled 
by the other entry points/ such as diskette file RENAME/ display 
DRAW/ etc. Specifically/ if the IOCB command byte value is 
greater than $OD/ then CIO will use the SPECIAL entry point. The 
handler must interrogate the command byte to determine if the 
requested operation is supported. 


At handler entry/ the following parameters can be of interest: 
X = index to originating IOCB. 

Y m $92 (status = function not implemented by handler). 

ICDNOZ E00213 = device number (1-4/ for multiple device 

handlers ) . 

ICCOMZ Z 0022 3 ■ command byte. 

ICBALZ/ICBALH C0024/00253 = buffer address. 

ICBLLZ/ICBLHZ C0028/00293 = buffer length. 

ICAX1Z/ICAX2Z C002A/002B 3 = device-specific information. 


OPERATING SYSTEM CO 16555 — Section 9 


139 



The handler will perform the indicated operation* if possible* 
and return to CIO with the operation status in register Y. 

The IOCB need not be opened nor closed in order for you 
to request CIO to perform a SPECIAL operation* the handler 
must check where there are restrictions. See Section 5 for a 
discussion of the CIO actions involved with a SPECIAL 
operation using both open and closed IOCB's* and note the 
impact of this on the use of the buffer address parameter. 


Error Handling 

Error handling has been simplified somewhat by having CIO handle 
outer level errors and having SIO handle Serial bus errors* 
leaving the handler to process the remaining errors. These 
errors include: 

out-of -range parameters. 

CBREAK3 key abort. 

Invalid command. 

Read after end of file. 

The current handlers respond to errors using the following 
guidel ines: 

They keep the recovery simple (and therefore predictable and 
repeatab le ) . 

They Do not interact directly with you for recovery 
instruc tions. 

They lose as little data as possible. 

They make all attempts to maintain the integrity of file 
oriented device storage — this involves the initial design 
of the structural elements as well as error recovery 
techniques. 


Resource Allocation 

Nonresident handlers needing code and/or data space in RAM should 
use the techniques listed below* to assure nonconflict with other 
parts of the OS* including other nonresident handlers. 
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Zero-Page RAM 


Zero-page RAM has no spare bytes, and even if there were, there 
is no allocation scheme to support multiple program assignment of 
the spares. Therefore, the nonresident handler must save and 
restore the bytes of zero-page RAM it is going to use. The bytes 
to use must be chosen carefully, according to the following 
criteria: 

The bytes cannot be accessed by an interrupt routine. 

The bytes cannot be accessed by any noninterrupt code 
between the time the handler modifies the bytes and then 
restores the original values. 

A simple save/restore technique would utilize the stack in a 
manner similar to that shown below: 


LDA 

COLCRS 

; (for example) 

PHA 


i SAVE ON STACK. 

LDA 

PHA 

COLCRS+1 


LDA 

HPOINT 

; HANDLER'S POINTER. 

STA 

COLCRS 


LDA 

HPOINT+1 


STA 

COLCRS+1 


XXX 

(COLCRS), Y 

i DO YOUR POINTER THING 

PLA 


; RESTORE OLD DATA. 

STA 

PLA 

COLCRS+1 


STA 

COLCRS 



Note that the Display Handler or Screen Editor should not be 
called before restoring the original value of COLORS, because 
COLCRS is a variable used by those routines. 

Nonzero-Page RAM 

There is no allocation scheme to support the assignment of 
fixed regions of nonzero-page RAM to any specific process, so the 
handler has three choices: 

1. Make a dynamic allocation at ini t ial i zat ion time by 
altering MEMLO C02E73. 

2. Include the variables with the handler for RAM-resident 
handlers. This still involves altering MEMLO at the time 
the handler is booted. 

3. If the handler replaces one of the resident handlers (by 
removing the resident handler's entry in the device 
table), then the new handler can use any RAM that the 
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formerly resident handler would have used. 

Stack Space 

In most cases/ there are no restrictions on the use of the stack 
by a handler. However/ if the handler plans to push more than a 
couple dozen bytes to the stack/ then it should do a stack 
overflow test/ and always leave stack space for interrupt 
processing. 


HANDLER /S 10 INTERFACE 

This section describes the interface between serial bus device 
handlers and the serial bus I/O utility (SIO). SIO completely 
handles all bus transactions following the device-independent bus 
protocol. SIO is responsible for the following functions: 

Bus data format and timing from computer end. 

Error detection/ retries and statuses. 

Bus timeout. 

Transfer of data between the bus and the caller's buffer. 


Calling Mechanism 

SIO has a single entry point SIOV CE4593 for all operations. The 
device control block (DCB) C03003 contains all parameters passed 
to SIO. The DCB contains the following bytes: 

DEVICE BUS ID — DDEVIC C03003 

The bus ID of the device is set by the handler prior to calling 
SIO (see Appendix I). 

DEVICE UNIT # — DUNIT C03013 

This byte indicates that of n units of a given device type to 
access/ and is set by the handler prior to calling SIO. This 
value usually comes from ICDNOZ. SIO accesses the bus device 
whose address is equal to the value of DDEVIC plus DUNIT minus 1 
(the lowest unit number is normally equal to 1). 

DEVICE COMMAND — DCOMND C03023 

The handler sets this byte prior to calling SIO. It will be sent 
to the bus device as part of the command frame. See Appendix I 
for device command byte values. 
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DEVICE STATUS 


DSTATS C 0303 3 


This byte is bidirectional. The handler will use DSTATS to 
indicate to SIO uihat to do after the command frame is sent and 
ac knowledged. SIO will use it to indicate to the handler the 
status of the requested operation. 

Prior to an SIO call: 

7 O 

«W»‘Ri unused I 

4. — ►-—■+- — ^ — | | t-— 4 - — h 

Where: W/ R = Of O indicates no data transfer is associated with the 

operation. 

0/1 indicates a data frame is expected from the device 
1/0 indicates a data frame is to be sent to the device 
1/ 1 is invalid. 


After an SIO call: 

7 0 

+-+-+“+— +-+”+-4—+ 
i status code ! 

4. — 4 — f — 4-4--+ — h~+—+ 

See Appendix C for the possible SIO operation status codes. 

HANDLER BUFFER ADDRESS — DBUFLO/DBUFHI C0304/03053 

The handler sets this 2-byte pointer. It indicates the source 
or destination buffer for device data or status information. 

DEVICE TIMEOUT — DTIMLO C03063 

The handler sets this byte. It specifies the device timeout time 
in units of 64/60 of a second. For example/ a count of 6 
specifies a timeout of 6. 4 seconds. 

BUFFER LENGTH/BYTE COUNT — DBYTLO/DBYTHI C0308/03093 

The handler sets this 2-byte count for the current 
operation/ and indicates the number of data bytes to be 
transferred into or out of the buffer. This parameter is not 
required if the STATUS byte W and R bits are both zero. These 
values indicate that no data transfer is to take place. 

WARNING: There is a bug in SIO that causes incorrect 
actions when the last byte of a buffer is in a memory 
address ending in $FF/ such as 13FF# 42 FF# etc. 
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AUXILIARY INFORMATION 


DAUX1/DAUX2 C030A/030B3 


The handler sets these 2-bytes. The SIO includes them in the bu 
command frame; they have device-spec i f ic meanings. 


Functions Supported 

SIO does not examine the COMMAND byte it sends to the device* 
because all bus transactions are expected to conform to a 
universal protocol. The protocol includes three forms* stated 
below (as seen from the computer): 

Send command frame. 

Send command frame and send data frame. 

Send command frame and receive data frame. 

The values of the W and R bits in the status byte select the 
command form. 


Error Handling 

SIO handles most of the serial bus errors for the handler* 
as indicated below: 

Bus timeout — SIO provides a uniform command frame and data 
frame ACK byte timeout of 1/60 of a second - 0 / + 1/60. 

The handler specifies the maximum COMPLETE byte timeout 
value in DTIMLO. 

Bus errors — SIO detects and reports UART overrun and 
framing errors. The sensing of these errors in any received 
byte will cause the entire associated frame to be considered 
bad. 

Data frame checksum error — SIO validates the checksum on 
all received data frames and generates a checksum for all 
transmitted frames. 

Invalid response from device — In addition to the error 
conditions stated above* SIO checks that the ACK and 
COMPLETE responses are proper (ACK = $41 and COMPLETE * 

$43). ACK stands for acknowledge. 

Bus operation retries — SIO will attempt one complete command 
retry if the first attempt is not error free* where a complete 
command try consists of up to 14 attempts to send (and 
acknowledge) a command frame* followed by a single attempt to 
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receive the COMPLETE code and possibly a data frame. 


NOTE: There is a bug in the retry logic for data writes* 
such that if the command frame is acknowledged by the 
controller* but the data frame is not acknowledged* then SIO 
will retry indefinitely. 

Unified error status codes — SIO provides device-independent error 
codes (see Appendix C). 


SERIAL I/O BUS CHARACTERISTICS AND PROTOCOL 
This section describes: 

o The electrical charac ter ist ics of the ATARI 400 
and ATARI 800 Home Computers serial bus 

o The use of the bus to send bytes of data* 

o The organization of the bytes as “frames" (records)* 

o The overall command sequences that utilize frames 

and response bytes to provide computer/per ipheral communication. 


Hardware /Elec tr ical Charac ter ist ics 

The ATARI 400 and the ATARI 800 Home Computers 
communicate with peripheral devices over a 19*200 baud 
asynchronous serial port. The serial port consists of a serial 
DATA OUT (transmission) line* a serial DATA IN (receiver) line 
and other miscellaneous control lines. 

Data is transmitted and received as 8 bits of serial data (LSB 
sent first) preceded by a logic zero start bit and succeeded 
by a logic one stop bit. The serial DATA OUT is transmitted as 
positive logic (+4v = one/true/high* Ov * zero/false/low). The 
serial DATA OUT line always assumes its new state when the 
serial CLOCK OUT line goes high* CLOCK OUT then goes low in 
the center of the DATA OUT bit time. 

An end view of the Serial bus connector at the computer or 
peripheral is shown below (the cable connectors would of 
course be a mirror image): 


OPERATING SYSTEM C016555 — 


Section 9 


145 



0 

1 


2 4 6 8 10 12 

o o o o o o 

O 0 o o o o 

3 5 7 9 11 13 


where: 1 = computer CLOCK IN. 

2 = computer CLOCK OUT. 

3 « computer DATA IN. 

4 * GND. 

5 == computer DATA OUT. 

6 » GND. 

7 = COMMAND-. 

8 = MOTOR CONTROL. 

9 = PROCEED-. 

10 * +5v/READY. 

11 = computer AUDIO IN. 

12 = + 12v. 

13 » INTERRUPT-. 

Figure 9-4 Serial Bus Connector Pin Descriptions 


CLOCK IN is not used fay the present OS and peripherals. This 
line can be used in future synchronous communications schemes. 

CLOCK OUT is the serial bus clock. CLOCK OUT goes high at the 
start of each DATA OUT bit and returns to low in the middle of 
each bit. 

DATA IN is the serial bus data line to the computer. 

Pin 4 GND is the signal/sh ield ground line. 

DATA OUT is the serial bus data line from the computer. 

Pin 6 GND is the signal/shield ground line. 

COMMAND- is normally high and goes low when a command frame is 
being sent from the computer. 

MOTOR CONTROL is the cassette motor control line <high=oni 
low= off). 

PROCEED- is not used by the present OS and peripherals; this line 
is pulled high. 

+5v/READY indicates that the computer is turned on and ready. This 
line can also be used as a +5 volt supply of 5Gma current rating 
for ATARI peripherals only. 

AUDIO IN accepts an audio signal from the cassette. 
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+ 12V is a +12 volt supply of unknown current rating for ATARI 
peripherals only. 

INTERRUPT- is not used by the present OS and peripherals; this 
line is pulled high. 

There are no pin reassignments made in the Serial bus cable* 
so pin 3 » the computer's DATA IN line* is the peripheral's 
data output line* and similarly for pin 5. 


Serial Port Electrical Specifications 

Peripheral input: 

V1H = 2. Ov min. 

V1L = 0. 4v max. 

I1H = 20ua. max. @ V1H = 2. Ov 
I1L = 5ua. max. @ V1L = . 4v 

Peripheral output (open collector bipolar): 

VOL = 0. 4v max. € 1.6 ma. 

VOH = 4. 5v min. with external lOOKohm pull-up. 
Vcc /READY input: 

V1H = 2. Ov min. @ I1H = Ima. max. 

V1L = 0. 4v max. 

Input goes to logic zero when open. 


Bus Commands 

The bus protocol specifies that ail commands must originate from the 
computer* and that peripherals will present data on the bus only when 
commanded to. Every bus operation will go to completion before 
another bus operation is initiated (no overlap). An error detected at 
any point in the command sequence will abort the entire sequence. 

A bus operation consists of the following elements: 

Command frame from the computer. 

Acknowledgement (ACK) from the peripheral. 

Optional data frame to or from the computer. 

Operation complete (COMPLETE) from the peripheral. 
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Command Frame 


The serial bus protocol provides for three types of commands: 1) 
send* 2) data receive and 3) immediate (no data — command only). 
There is a common element in all three types/ a command frame 
consisting of five bytes of information sent from the computer 
while the COMMAND- line is held low. The format of the command 
frame is 
shown below: 


+ + 

! device ID ! 

•+• + 

I command ! 

4 * — — — — — — — — — — + 

i auxiliary #1 i 

+ + 

* auxiliary #2 i 

+ + 

I checksum « 

+ + 

Figure 9—5 Serial Bus Command Frame Format 

The device ID specifies that of the serial bus devices is being 
addressed (see Appendix I for a list of device IDs). 

The command byte contains a device-dependent command (see 
Appendix I for a list of device commands). 

The auxiliary bytes contain more device-dependent information. 

The checksum byte contains the arithmetic sum of the first four 
bytes (with the carry added back after every addition). 


Command Frame Acknowledge 

The peripheral being addressed would normally respond to a 
command frame by sending an ACK byte ($41) to the computer; if 
there is a problem with the command frame* the peripheral should 
not respond. 


Data Frame 
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Following the command frame (and ACK) can be an optional data 
frame that is formatted as shown below: 


+ — — — . — — — — — — — •— — 4- 


data 

bytes 


+ + 

{ checksum { 

4. — — 4. 


This data frame can originate at the computer or at the device 
controller* depending upon the command. Current device 
controllers expect fixed-length data frames as does the computer* 
where the data frame length is a fixed function of the device 
type and command. 

The checksum value in the data frame is the arithmetic sum of all 
of the frame data preceding the checksum* with the carry from 
each addition being added back (the same as for the command 
frame ) . 

In the case of the computer sending a data frame to a peripheral* 
the peripheral is expected to send an ACK if the data frame is 
acceptable* and send a NAK ($4E)* or do nothing if the data frame 
is unaccep tab le. See the first flowchart in Section 9. 


Operation Complete 

A peripheral is also expected to send an operat ion-COtiPLETE byte 
($43) at the time the commanded operation is complete. The 
location of this byte in the command sequence for each command 
type is shown in the timing diagrams in Section 9. If the 
operation cannot go to normal* error-free completion* the 
peripheral should respond with an ERROR byte ($45) instead of 
COMPLETE. 
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Bus Timing 


This section provides timing diagrams for the three types of 
command sequences: data send/ data receive/ and immediate. 


DATA SEND sequence: 


+ 4 

COMMAND- { ! 

4 - 4 


DATA OUT 


+ 4 / / h 

• cmnd ! ! data I 

♦frame + // — + frame + 


DATA IN 


4-4 


•4 +■ 
ACK 


4 h +— ♦ 

l ( II 

It ft 

“♦ 4 // 4 4 - 

ACK CMPL 


tO tl t2 t3 


t4 t5 


DATA RECEIVE sequence: 


4 4 

COMMAND- ! { 

4 4 


4 4 

DATA OUT ! cmnd ! 

4 frame 4 


DATA IN 


tO tl 


•4 h 

l 

4 

4 

1 

4 

// 4 

t < 

t t 

i t i 

i i i 

data ! 

4 4 //- 

-4 4-4 

frame 4- 

ACK 

CMPL 



t2 t5 
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IMMEDIATE sequence: 


+ 4 - 

COMMAND- ! { 

4. + 

■+• + 


DATA OUT ! cmnd ! 

4-frame + 


DATA IN i ! 

+ 4 - // 

ACK 


tO tl t2 t5 

Figure 9-6 Serial Bus Timing Diagram 


The computer generates a delag <tO> between the lowering of COMMAND 
and the transmission of the first byte of the command frame. 

computer tO (min) = 750 microsec. 
computer tO (max) = 1600 microsec. 

peripheral tO (min) * ?? 
peripheral tO (max) = *?? 

The computer generates a delay (tl) between the transmission of 
the last bit of the command frame and the raising of the CQMMAND- 
1 ine. 

computer tl (min) = 650 microsec. 
computer tl (max) = 950 microsec. 

peripheral tl (min) = ?? 
peripheral tl (max) * ?? 

The peripheral generates a delay (t2) between the raising of 
COMMAND- and the transmission of the ACK byte by the peripheral. 

computer t2 (min) » O microsec. 
computer t2 (max) * 16 msec. 

peripheral t2 (min) = ?? 
peripheral t2 (max) = ?? 
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The computer generates a delay (t3) between the receipt of the 
last bit of the ACK byte and the transmission of the first bit of 
the data frame by the computer. 

computer t3 (min) - 1000 microsec. 
computer t3 (max) = 1800 microsec. 

peripheral t3 (min) = ?? 
peripheral t3 (max) = ?? 

The peripheral generates a delay (t4) between the transmission of 
the last bit of the data frame and the receipt of the first bit 
of the ACK byte by the computer. 

computer t4 (min) * 850 microsec. 
computer t4 (max) = 16 msec. 

peripheral t4 (min) = ?? 
peripheral t4 (max) = ?? 

The Peripheral generates a delay (t5) between the the receipt of 
the last bit of the ACK byte and the first bit of the COMPLETE 
byte by the computer. 

computer t5 (min) = 250 microsec. 

computer t5 (max) =255 sec. (handler-dependent) 

peripheral t5 (min) = ?? 
peripheral t5 (max) = N/A 


HANDLER ENVIRONMENT 

Nonresident handlers can be installed in at least three different 
manners: 

1. As booted software from diskette or cassette. 

2. Resident in a cartridge (A or B). 

3. Downloaded from a serial bus device. 

This section will discuss the basic mechanisms for handler 
installation for these environments. In order to fully utilize the 
information in this section* you must have read and understood the 
following sections: 


Program environments Section 3 

RAM region Section 4 

Memory dynamics Section 4 

System ini t ial i zation Section 7 


Adding new device hand lers/per ipherals . Section 9 
Program environment and ini t ial i zation . Section 10 
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Bootable Handler 


The diskette- or cassette-booted software will insert the 
handler's vector table pointer and name to the device table 
whenever the booted software's initialization entry point is 
entered (on power-up and system reset). Remember that both 
power-up and system reset clear the device table of all but th 
resident handler entries. 


Cartridge Resident Handler 

The cartridge software will insert the handler's vector table 
pointer and name to the device table whenever the cartridge's 
initial i zation entry point is entered (on power-up and 
system reset). Remember that both power-up and system reset 
clear the device table of all but the resident handler entries 
therefore the device table must be reestablished by the 
handler-initiali zation procedure upon every entry. 


FLOWCHARTS 

The following pages contain process flowcharts showing the SIO 
and peripheral actions for the Serial bus command forms. 
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PERIPHERAL’S COMMAND FRAME PROCESSING 
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DATA FRAME TO PERIPHERAL 
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10 PROGRAM ENVIRONMENT AND INITIALIZATION 


This section discusses possible alternative software environments 
using OS Configurations. Environments other than those discussed 
here are also possible. A thorough unders tand ing of the powei — up 
and system reset processes (see Section 7) will be necessary to 
evaluate all alternative environments. 


CARTRIDGE 

Most games (and some language processors) are supported via the 
cartridge environment. The cartridge resident software is in 
control of the system/ sometimes using the OS and sometimes not. 
A cartridge can specify whether the diskette is to be booted at 
power-up time/ whether the cartridge is to provide the 
controlling software, or whether the cartridge is a special 
diagnostic cartridge. These options are specified by bits in the 
cartridge header, as shown below: 


+ + 

« cartridge « BFFA (9FFA for cartridge B) 

I start address { 

+ + 

\ 00 i 

I option byte * 

+ + 

! cartridge f 

+- —+ 

« init address BFFF (9FFF for cartridge B) 


Figure 10-1 Cartridge Header Format 

The byte of "00“ is used to allow the OS to determine when a 
cartridge is inserted; locations BFFC and 9FFC will not read zero 
when there is neither RAM at those locations nor a cartridge 
inserted. RAM is differentiated from a cartridge by its ability 
to be altered. 
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The option byte has the following option bits: 

bit 0 = Oi then do not boot the diskette. 

1, then boot the diskette. 

Bit 2 = 0/ then init but do not start the cartridge. 

1# then init and start the cartridge. 

bit 7=0/ then cartridge is not a diagnostic cartridge. 

1/ then cartridge is a diagnostic cartridge and control 
will be given to the cartridge before any of the OS 
is initialized (JMP (BFFE) ) . 

The cartridge init address specifies the location to which the OS will 
JSR during all power-up and system reset operations. As a minimum/ 
this vector should point to an RTS instruction. 

The cartridge start address specifies the location to which the OS 
will JMP during all power-up and system reset operations/ if 
bit 1 of the option byte is = 1. The application should examine 
the variable WARMST C00083 if system reset action is to be 
different than power-up (WARMST will be zero on power-up and 
nonzero thereafter). 


Cartridge Without Booted Support Package 

A cartridge that does not specify the diskette-boot option and does 
not support the cassette-boot possibility can use lower memory 
(from 0480 to the address in MEMTOP C02E53) in any way it sees 


Cartridge With Booted Support Package 

A cartridge that does specify the diskette-boot option or does 
support the cassette-boot possibility must use some care in its 
use of lower memory. The following regions are defined: 

0480-06FF is always available to the cartridge. 
MEMLO/MEMTOP region is always available to the cartridge. 


DISKETTE-BOOTED SOFTWARE 

Software can be booted from the disk drive at power-up time in 
response to one of the following conditions: 
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Neither Cartridge A nor B is inserted. 


Cartridge A 
CBFFD3 = 1. 

is 

inserted 

and 

has 

bit 

0 of 

its 

option 

byte 

Cartridge B 
C9FFD3 = 1. 

i s 

inserted 

and 

has 

bit 

0 of 

its 

option 

byte 

If any of these conditions are 

met* 

the 

OS 

will 

attempt to 

read 


the boot record from sector #1 of disk drive 1 and then transfer 
control to the software that was read in. The exact sequence of 
operations will be explained later in this section. 


Diskette-Boot File Format 

The key region of a diskette-boot file is the first six bytes* which 
are formatted as shown below: 


Figure 10-2 


+ 


' + 


\ flags \ 

4. + 

! # of sectors \ 


first 


+ 


+ 


i memory address i 

H — — h 

S to start load I 


4. 4 

I init ! 

4 -- - + 

! address ! 

+ 4 

< boot < 


continuation 

code 


sixth 


Diskette-Boot File Format 


byte 


byte 


The first byte is stored in DFLAGS C02403* but is otherwise 
unused. It should equal zero. 

The second byte contains the number of 128-byte diskette sectors 
to be read as part of the boot process (including the record 
containing this information). This number can range from 1 to 
255* with O meaning 256. 
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The third and fourth bytes contain the address do* hi) at which to 
start loading the first byte of the file. 

The fifth and sixth bytes contain the address do* hi) to which the 
booter will transfer control after the boot process is complete 
and whenever the CSYSTEM. RESET! key is pressed. 

The Diskette File Management System (FMS) has extra bytes assigned to 
its boot record/ but this is a special case of the generalized 
diskette-boot and is discussed in Section 5. 


Diskette-Boot Process 

If no cartridge is installed/ then the diskette will follow these 
steps to boot up: 

1. Read the first diskette record to the cassette buffer £04003. 

2. Extract information from the first six bytes: 

Save the flags byte to DFLAGS £0240/ 13. Save the # of sectors 
to boot to DBSECT C0241/13. Save the load address to BOOTAD 
£0242/23. Save the initial i zation address in DOSINI £0000/23. 

3. Move the record just read to the load address specified. 

4. Read the remaining records directly to the load area. 

5. JSR to the load address+6 where a multistage boot process can 
continue. The carry bit indicates the success of this 
operation (carry set = error/ carry reset = success). 

NOTE: During step 5/ after the initial boot process is 

complete/ the booter will transfer control to the seventh byt 
of the first record. The software should continue the boot 
process at this point/ if it is a multistage boot. The value 
of MEMLO £02E73 should point to the first free RAM location 
beyond the software just booted. It should be established by 
the booted software as shown below: 


LDA 

#END+1 

; SET 

UP 

LSB 

STA 

MEMLO 




STA 

APPMHI 




LDA 

#END+ 1/256 

; SET 

UP 

MSB 

STA 

MEMLO+1 




STA 

APPMHI +1 





If the booted software is to take control of the 
system at the end of the boot operation/ the 
vector DQSVEC £G0QA3 must be set up by the 
application at this time; DQSVEC points to the 

OPERATING SYSTEM C016555 — Section 10 

160 



restart entry for the booted application. If the 
booted software is not to take control/ then 
DOSVEC should remain unchanged. 


LDA 

#RESTRT 

; RESTART LSB 

STA 

DOSVEC 


LDA 

#RESTRT/256 


STA 

DOSVEC +1 



6. JSR indirectly through D0S1NI for initial i zat ion of the 
application; the application will initialize and return. 

NOTE: The OS enters the initialization point on every 
system reset and power-up. Internal ini tial i zat ion can take 
place during system reset and power-up as well. Ini t ial i zat ion 
can also be deferred until Step 7 for controlling 
app 1 icat ions. 


7. JMP indirectly through DOSVEC to transfer control to the 
app 1 icat ion. 

NOTE: Pressing the CSYSTEM. RESET3 key after the application 

is fully booted will cause steps 6 and 7 to be repeated. 


Sample Diskette-Bootab le Program Listing 

This skeletal program can be booted from the diskette. It retains 
control when it is entered. 


; THIS IS THE START OF THE PROGRAM FILE. 

PST=s $0700 ; <0R SOME OTHER LOCATION). 

*» PST ; (.ORG). 


; THIS IS THE diskette-boot CONTROL INFORMATION. 

. BYTE 0 ; 

.BYTE PND— PST + 1 27 / 1 28 ; NUMBER OF RECORDS. 

. WORD PST ; MEMORY ADDRESS TO START LOAD. 

.WORD PINIT ; PROGRAM INIT. 
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; THIS IS THE START OF THE BOOT CONTINUATION. 


LDA 

#PND 

i ESTABLISH LOW MEMORY LIMITS. 

STA 

MEMLO 


STA 

APPMHI 


LDA 

#PND/256 


STA 

MEMLO+1 


STA 

APPMHI+1 


LDA 

#RESTRT 

i ESTABLISH RESTART VECTOR. 

STA 

DOSVEC 


LDA 

#RESTRT/256 


STA 

DOSVEC +1 


CLC 

RTS 


i SET FLAG FOR SUCCESSFUL BOOT 


; APPLICATION INITIALIZATION ENTRY POINT. 

PINIT RTS i NOTHING TO DO HERE FOR . . . 

i ... CONTROLLING APPLICATION. 

; THE MAIN BODY OF THE PROGRAM FOLLOWS. 

RESTRT=* 

; THE MAIN BODY OF THE PROGRAM ENDS HERE. 

PND= * ; 'PND' * NEXT FREE LOCATION. 

. END 

Figure 10-3 Diskette-Bootable Program Listing Example 


Program to Create Diskette-Boot Files 

This section provides a program that can be used to make bootable 
files on diskettes. The program given is not the only one possibl 
and no claims are made as to its elegance. 
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Shown below is a listing of the program to create diskette-boot files. 

; THIS PROGRAM WRITES A SINGLE "FILE** TO THE DISKETTE AND IS 
; USED IN CONJUNCTION WITH A PROCEDURE TO MAKE DISKETTE- 
; BOOTABLE FILES. THE FOLLOWING TWO SYMBOLS MUST BE EQUATED 
; USING THE MEMORY LIMITS OF THE PROGRAM TO BE COPIED: 

; 'PST' = PROGRAM START ADDRESS (SEE SAMPLE PROGRAM). 

; 'PND' ■ PROGRAM END ADDRESS (SEE SAMPLE PROGRAM). 


SECSIZ=128 i DISKETTE SECTOR SIZE. 

PST= $0700 
PND* $1324 

FLEN* PND-PST+SECSI Z-l /SECSI Z ; # OF SECTORS IN FILE. 
*= $B000 ; THIS PROGRAM'S ORIGIN. 


BOOTB BRK 


i 

*** LOAD APPLICATION *** 

; SET UP DEVICE CONTROL 

BLOCK FOR DISKETTE HANDLER CALL 

LDA 

#FLEN 

I 

# OF SECTORS TO WRITE. 

STA 

COUNT 



LDA 

#1 

i 

DISK DRIVE #1. 

STA 

DUN IT 



LDA 

#'W 

i 

SET UP FOR WRITE WITH CHECK. 

STA 

DCOMND 



LDA 

#PST 

f 

POINT TO START OF APPLIC. PROG. 

STA 

DBUFLO 



LDA 

#PST/256 



STA 

DBUFHI 



LDA 

#01 

i 

SET UP STARTING SECTOR # * 0001 

STA 

DAUX1 



LDA 

#00 



STA 

DAUX2 
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; NOW WRITE THE FILE ONE SECTOR AT A TIME. 


BOTOIO 

JSR 

DSKINV 

i 

WRITE ONE SECTOR 



BMI 

DERR 

i 

ERROR. 



LDA 

DBUFLO 

i 

INCREMENT MEMORY 

ADDRESS. 


CLC 






ADC 

#SECSIZ 





STA 

DBUFLO 





LDA 

DBUFHI 





ADC 

#0 





STA 

DBUFHI 





INC 

DAUX1 

i 

INCREMENT SECTOR 

#. 


BNE 

B0T020 





INC 

DAUX2 




B0T020 

DEC 

COUNT 

i 

MORE SECTORS TO 

WRITE? 


BNE 

BOTOIO 

9 

YES. 



BRK 


9 

STOP WHEN DONE. 


DERR 

BRK 


i 

STOP ON ERROR. 


COUNT 

*=*+1 


i 

SECTOR COUNT. 


i THIS 

IS THE 

CARTRIDGE 

HEADER 



*= 

*BFF9 


9 

"A" CARTRIDGE. 


INIT 

RTS 






. WORD 

BOOTB 





. BYTE 

0* 4 





. WORD 

INIT 





. END 






CASSETTE— BOOTED SOFTWARE 

You can boot software from the cassette as well as from the 
diskette* at power-up. The following requirements must be met in order 
to boot from the cassette: 

o You must be pressing the CSTART3 keg as power is 
applied to the system. 

o A cassette tape with a proper boot format file must be 

installed in the cassette drive* and the PLAY button must be 
pressed. 
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o When you are given the audio prompt by the cassette 
handler you must press the CRETURN3 key. 

If all of these conditions are met/ the OS will read the boot file 
from the cassette and then transfer control to the software that 
was read in. The exact sequence of operations will be explained 
later in this section. 


Cassette-Boot File Format 

The key region of a cassette-boot file is the first six bytes/ that 
are formatted as shown below: 


+ + 

I # of Records ! 
+ + 

* Memory Address ! 
+ — — + 
! To Start Load ! 

4. + 

} Init ! 

4. — — 4. 

i address ! 


The first byte is not used by the cassette-boot process. 

The second byte contains the number of 128-byte cassette records to 
be read as part of the boot process (including the record 
containing this information). This number can range from 1 to 255/ 
with 0 meaning 256. 

The third and fourth bytes contain the address (lo/hi) to which the 
booter will transfer control after the boot process is complete and 
whenever the C SYSTEM. RESET 3 key is pressed. 

Cassette-Boot Process 

The cassette-boot process is described step-by-step for a 

conf igurat ion in that no cartridge is installed and no diskettes are 

attached. For the general case see Section 7. 

1. Read the first cassette record to the cassette buffer. 

2. Extract information from the first six bytes: 
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Save the # of records to boot. Save the load address. Save 
the ini tial i zation address in CASINI COGQ23 

3. Move the record just read to the load address specified. 

4. Read the remaining records directly to the load area. 

5. JSR to the load address+6 where a multistage boot process 
can continue; the carry bit will indicate the success of 
this operation (carry set-error* carry reset=success ) . 

6. JSR indirectly through CASINI for initial i zat ion of the 
application; the application will initialize and return. 

7. JMP indirectly through DOSVEC to transfer control to the 
app 1 icat ion. 

Pressing the C SYSTEM. RESET! key after the application is fully booted 
will cause steps 6 and 7 to be repeated. 

NOTE: After the initial boot process is complete* the booter will 

transfer control to the seventh byte of the first record; at this 
point the software should continue the boot process (if it is a 
multistage boot) and then stop the cassette drive* which due to a 
system bug will still be running* using the following instruction 
sequence: 

LDA #$3C 

STA PACTL CD302! 

The application should then set a value in MEMLO £0237! that 
points to the first free RAM location beyond the software just 
booted* as shown below: 

LDA #END+1 

STA MEMLO 

STA APPMHI 

LDA #END+ 1/256 

STA MEMLO+1 

STA APPMHI +1 

If the booted software is to take control of the system at the end 
of the boot operation* the vector DOSVEC COOOA! must be set up by 
the application at this time; DOSVEC points to the restart entry 
for the booted application. If the booted software is not to take 
control* then DOSVEC should remain unchanged. 

LDA #RESTRT ; RESTART LSB 

STA DOSVEC 

LDA #RESTRT/256 

STA DOSVEC +1 


NOTE: The initial i zat ion point is entered on every system reset 
and power-up; internal in i t ia 1 i zat i on can take place here. 
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For controlling applications initialization can also be deferred 
until step 7. 


Sample Cassette-Bootab le Program Listing 

Shown below is a skeletal program that can be booted from the 
cassette and that retains control when it is entered. 

; THIS IS THE START OF THE PROGRAM FILE. 

PST= $0700 i (OR SOME OTHER LOCATION). 

*= PST ; < . ORG ) . 


i THIS IS THE cassette-boot CONTROL INFORMATION. 

. BYTE O i < DOESN 'T MATTER ) . 

.BYTE PND-PST+127/128 i NUMBER OF RECORDS. 

. WORD PST i MEMORY ADDRESS TO START LOAD. 

.WORD PINIT ; PROGRAM INIT. 

; THIS IS THE START OF THE BOOT CONTINUATION. 


LDA 

#*3C 

; STOP THE CASSETTE. 

STA 

PACTL 


LDA 

#PND 

i ESTABLISH LOW MEMORY LIMITS. 

STA 

MEMLO 


STA 

APPMHI 


LDA 

#PND/256 


STA 

MEMLO+1 


STA 

APPMHI+1 


LDA 

#RESTRT 

i ESTABLISH RESTART VECTOR. 

STA 

DOSVEC 


LDA 

#RESTRT/256 


STA 

DOSVEC+1 


CLC 


i SET FLAG FOR SUCCESSFUL BOOT 

RTS 

APPLICATION 

INITIALIZATION 

ENTRY POINT. 


PINIT RTS i NOTHING TO DO HERE FOR . . . 

; ... CONTROLLING APPLICATION. 

; THE MAIN BODY OF THE PROGRAM FOLLOWS. 

RESTRT=* 

; THE MAIN BODY OF THE PROGRAM ENDS HERE. 
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PND= 




PND 7 = NEXT FREE LOCATION. 



Program to Create Cassette-Boot Files 

This section provides a program listing that can be used to make 
bootable files on cassette tapes. The program given is not the only 
one possible# and no claims are made as to its elegance. 

Shown below is a listing of the program to create a cassette-boot 
file: 

; THIS PROGRAM WRITES A SINGLE FILE TO THE CASSETTE AND IS 
i USED IN CONJUNCTION WITH A PROCEDURE TO MAKE CASSETTE- 
i BOOTABLE FILES. THE FOLLOWING TWO SYMBOLS MUST BE EQUATED 
; USING THE MEMORY LIMITS OF THE PROGRAM TO BE COPIED: 

i 'PST' » PROGRAM START ADDRESS (SEE SAMPLE PROGRAM). 

* 'PND' = PROGRAM END ADDRESS (SEE SAMPLE PROGRAM). 

PST= *0700 
PND= *1324 

FLEN= PND-PST +127/1 28# 1 28 ; ROUND UP TO MULTIPLE OF 128. 

*= *B000 ; THIS PROGRAM'S ORIGIN. 

BOOTB LDX #*10 ; USE IOCB #1. 

; FIRST OPEN THE CASSETTE FILE FOR WRITING. 

LDA #OPEN ; SET UP FOR DEVICE “OPEN. " 

STA ICCOM, X 

LDA #OPNOT ; DIRECTION IS “OUTPUT. “ 

STA ICAX1* X 

LDA #*80 ; SELECT SHORT IRG. 

STA ICAX2, X 

LDA #CFILE i SET UP POINTER TO DEVICE NAME. 

STA ICBAL, X 

LDA #CFILE/256 

STA ICBAH, X 

JSR CIOV ; ATTEMPT TO OPEN FILE. 

BMI CERR # ERROR. 

i NOW WRITE THE ENTIRE FILE AS ONE OPERATION. 
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LDA 

#PUTCHR 

} 

SET UP FOR “PUT CHARACTERS. « 

STA 

ICCOMi X 



LDA 

#PST 

i 

POINT TO START OF APPLIC. PROG 

STA 

ICBAL# X 



LDA 

#PST/256 



STA 

ICBAHi X 



LDA 

#FLEN 

i 

SET UP # OF BYTES TO WRITE. 

STA 

ICBLL# X 



LDA 

#FLEN/256 



STA 

ICBLH< X 



JSR 

CIOV 

i 

WRITE ENTIRE FILE. 

BMI 

CERR 

§ 

ERROR. 


i NOW CLOSE THE FILE AFTER SUCCESSFUL WRITE. 



LDA 

STA 

#CLOSE 

ICCOM, X 

SET UP FOR “CLOSE 


JSR 

BMI 

CIOV 

CERR i 

CLOSE THE FILE. 
ERROR. 


BRK 

/ 

STOP WHEN DONE. 

CERR 

BRK 

# 

STOP ON ERROR. 

CFILE 

. BYTE 

“C : “/ CR 

FILE NAME. 

» THIS 

IS THE 

CARTRIDGE HEADER 


*=! 

$BFF9 

/ 

"A" CARTRIDGE. 

INIT 

RTS 
. WORD 
. BYTE 

BOOTB 

0, 4 



. WORD 
. END 

INIT 
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11 ADVANCED TECHNIQUES AND APPLICATION NOTES 


This section presents information to use the capabilities of the OS 
and some of the hardware capabilites that aren't directly available 
through the OS # and in fact/ can be in direct conflict with parts of 
the OS. 


SOUND GENERATION 

The OS uses the POKEY sound generation capabilities only in the I/O 
subsystem# for cassette FSK tone generation# and for the “noisy 
bus" option in SIO. 


Capab i 1 i ties 

The hardware provides four independently programmable audio 
channels that are mixed and sent to the television set as part of 
the composite video signal. The POKEY registers shown below are all 
concerned with sound control (as described in the ATARI Home 
Computer Hardware Manual). 

AUDCTL CD2083 

AUDC1 CD2013 and AUDF1 CD2003 

AUDC2 CD2033 and AUDF2 CD2023 

AUDC3 CD2053 and AUDF3 CD2043 

AUDC4 CD2073 and AUDF4 CD2063 


Conflicts With OS 

There are two potential conflicts with the OS involving sound 

generat ion: 

o The OS can generate its own sounds and then turn off all sounds 
as part of I/O operations to the cassette and the serial bus 
peripherals. 

o The OS does not turn off sounds when you press CSYSTEM. RESET3 or 
CBREAK3. If the sounds are to be turned off under those 
conditions# the controlling program must provide that capability. 
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Audio control. 
Channel 1 control. 
Channel 2 control. 
Channel 3 control. 
Channel 4 control. 



SCREEN GRAPHICS 


Hardware Capabilities 

The hardware capabilities for screen presentat ions are quite 
versatile; the OS uses a very small amount of the capability 
provided. The means of extension/ however/ are non-trivial; and 
making changes to a screen format while still utilizing the 
resident Display Handler will be difficult. See the ATARI Home 
Computer Hardware Manual for information regarding screen 
presentations. 


OS Capabilities 

The resident Display Handler arbitrarily supports 8 of the 11 
possible full screen modes <11 of 14 modes if the GTIA chip is used 
in place of the CTIA). The resident Display Handler allows for an 
optional “split-screen" text window of fixed size. The hardware 
allows for many more options than the Display Handler supports/ as 
will be seen by reading the ATARI Home Computer Hardware 
Manual. 


Cursor Control 

You can control the Display Handler text and graphics cursors 
directly (see Section 5 and Appendix L< Bl-4). 


Color Control 

You can alter the color register assignments that the Display 
Handler makes upon all OPEN commands (see Appendix L B7-8 and 
elsewhere). Note that every system reset or Display Handler OPEN 
will reset the values back to the system default. 
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Alternate Character Sets 

Tuio character sets are available in screen text modes 1 and 2. The 
value stored in the data base variable CHBAS C02F43 selects the 
character set of interest to you. The default value of $E0 
provides capital (uppercase) letters* numbers and the punctuation 
characters corresponding to display codes $20 through $5F in 
Appendix E). The alternate value of $E2 provides lowercase letters 
and the special character graphics set ( correspond ing to display 
codes $60 through $7F and $00 through $1F in Appendix E>. 

User-defined character sets can also be obtained for text modes 0/ 

1* and 2 by providing the character matrix definitions in RAM and 
setting CHBAS to point to those definitions. CHBAS always contains 
the most significant bits of the memory address of the start of the 
character definitions* as shown below: 


— 4 . — 4 - — — ! h 

CHBAS ! MSB !x x! Text mode 0 

+-4- — j. — ^ 

+ — +“+—+“+“+— +~+~+ 

I MSB !x{ Text modes 1 and 2 

+—+“+~+~+—+—+~+ — + 


Figure 11-1 User-Defined Character Set Bit Memory Addresses 

(X indicates an ignored address bit 
assumed to be 0. > 
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Each character is defined by an 8 x 8 bit matrix; the 
character is defined as shown below: 

7 0 

Byte +-+-+-+-+-+-+-+-+ 

<OiO'OiOiOiOSO!Oi 0 

iOiOilSlililSOiOS 1 

IOIllliO‘llliO'0! 2 

0 } 1 J 1 { 0 { 1 { 1 { 0 { 0 J 3 

4-— 4-—4-— 4-— 4-—4-—4-— 4-— 4- 

101 1 I 1 !01 1 { 1 S 0 ■ 0 < 4 

4- — ►._+„+ — *--+ — h-4-4 

50! 1 { 1 I0I0I0I0I0I 5 
! 0 ; O ! 1 I 1 J 1 ! 1 1 0 iO ! 6 

4- — •+■—•+•“+ — b — -4 — h — 4- — 4 

<0!0!0!0i0S0S0«0! 7 

4-— 4-— 4-— 4-— 4-— 4-— 4-— 4-— 4- 

Figure 11-2 User Defined 8x8 Character Matrix Bit Table 

The storage for the character set involves eight consecutive 
bytes for each character with characters ordered consecutively by 
their internal code value (see the discussion in Appendix L 
relating to B55>. 


Character base 


4- 

I 

I 

f 

I 

+ 

t 

f 

I 

f 

4* 

f 


< 

t 

4- 

i 

i 


+ 

i 

i 

i 

i 

4* 


Charac ter 

for 

code $00 


Charac ter 

for 

code $01 



Charac ter 

for 

code $7E 


Charac ter 

for 

code $7F 



+ 

t 

f 

i 

i 

4" 

i 

f 

i 

i 

4* 

i 


i 

t 

4- 

t 

i 

i 

i 

4- 

< 

i 

i 

« 

4* 


8 bytes 


increas ing 


addresses 


Figure 11-3 Character Base Diagram 
PLAYER/MISSILE GRAPHICS 

The OS makes no use of the p lay er/miss i le generation capability 
of the hardware. It can be used independently of the OS with no 
conf 1 ic t. 
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Hardware Capabilities 


The hardware allows a number of independently moveable screen 
objects of limited width to be positioned and moved about the 
screen without affecting the "playfield" (bit-mapped graphics or 
character) data. Priority control allows the various objects to 
have a display precedence in case of conflict (overlap). 


Conflicts With OS 

You must assure that the p lay er /miss i le data is 
address-al igned as required by PMBASE CD4073. You also must 
find a suitable free area that the OS guarantees to be free under 
all environments. 


READING GAME CONTROLLERS 

The OS reads the game controllers (shown below) as part of the 
stage 2 VBLANK process (see Appendix L Jl-9): 

Joysticks/triggers 1-4. 

Paddle controllers/triggers 1-8. 

Driving controllers/triggers 1-4. 

Light pen/trigger 

In addition to these controllers/ other information can be sensed 
or sent using the PIA chip to that the console connectors are 
interfaced . 


Keyboard Controller Sensing 

Data can be read from an ATARI keyboard controller connected to the 
first port. This program alters registers on a chip called a PIA. 

To set these back to the default values to do further I/O, hit 
C SYSTEM. RESET! or POKE PACTLz 60. If this program is to be loaded from 
diskette/ use LOAD/ not RUN and wait for the busy light on the disk 
drive to go out. Do not execute the program before this light goes 
out/ otherwise the diskette continues to spin. 

1 GRAPHICS 0 

5 PRINT : PRINT " KEYBOARD CONTROLLER DEMO*' 

10 DIM R0W(3>z I*( 13)/ BUTTONS 1 ) 

30 GOSUB 6000 
40 FOR CNT=1 TO 4 

60 POSITION 2/ CNT*2+5: PRINT "CONTROLLER # *'» CNT; “ : 
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70 NEXT CNT 

80 FOR CNT=1 TO 4: GOSUB 7000: POSITION 19/ CNT+CNT+5: PRINT BUTTON*; 

: NEXT CNT 
120 GOTO 80 

6000 REN ** SET UP FOR CONTROLLERS ** 

6010 PQRTA=54016: P0RTB=54017: PACTL=54018: PBCTL=54019 
6020 POKE PACTL/ 48: POKE PORTA, 255: POKE PACTL, 52: POKE PORTA, 221 
6025 POKE PBCTL, 48: POKEPORTB, 255: POKE PBCTL, 52: POKE P0RTB,221 
6030 ROW CO >=238: ROWC 1 >=221 : R0W(2>=187: R0W<3>=119 
6040 I*=» 123456789*0#" 

6050 RETURN 

7000 REM ** RETURN BUTTON* WITH CHARACTER FOR BUTTON WHICH HAS 

BEEN PRESSED ON CONTROLLER CNT (1-4). ** 

7001 REM ** NOTE: A 1 WILL BE RETURNED IF NO CONTROLLER IS 
CONNECTED. ** 

7002 REM ** A SPACE WILL BE RETURNED IF THE CONTROLLER IS 
CONNECTED BUT NO KEY HAS BEEN PRESSED. ** 

7003 PORT=PORTA: IF CNT>2 THEN PORT=PORTB 
7005 P=1 

7008 PA0=CNT+CNT-2 
7010 FOR J=0 TO 3 
7020 POKE PORT, ROWC J> 

7030 FOR 1=1 TO 10: NEXT I 

7050 IF P ADDLE CPAQ+1 >>10 THEN P=J+J+J+2: GOTO 7090 
7060 IF PADDLE CPAO> >10 THEN P=J+J+J+3: GOTO 7090 
7070 IF STRIGCCNT-1 >=0 THEN P=J+J+J+4: GOTO 7090 
7080 NEXT J 
7090 BUTTON*=I*CP, P > 

7095 RETURN 


Figure 11-4 Reading Data From an ATARI Keyboard Controller 
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The table below shows the var iab le/reg ister values used for reading a 
keyboard controller from each of the four controller ports. 


Port 1 

! PORT A ! 
{direction! OF 
{bits * 

+ h“+— +—+”+-+—+ — +— 

! PORT B { 
{direction! - 
{bits ! 

! Port A 5 FE, FD, 

! row sel ! FB,F7 
! ec t ! 

h — i — * — — j — j — ^ 

! Port B { 

! row se- S - 
! lect } 

! Column 1 ! PADDL1 
! Sense ! 

{ Column 2 ' P ADDLO 
! Sense ! 

+-+-+ I h ► l h h“ 

! Column 3JSTRIG0 
{ Sense ! 

+ — + “+ i- h h — ■+" h — 


Port 2 

Port 3 Port 4 

< 

i i i 

1 

! FO 

t 

i t i 

t s __ f 

« i c 

C 1 1 

t 

- + - 
i 

+ 

i 

+ 

i 

+ 

i 

- + - 
i 

+ 

i 

+ 

i 

+ 

i 

- + - 

i 

< 

i < < 

! OF ! FO { 

1 t f 


1 < < 

! EF, DF 

{ BF, 7F 

1 

< < i 

i t * 

< < < 

4-~4— +-+- 

iff 

4* — 4* — - 4 * — - 4 - —* 4 * — 4 * — 4 * — - — 4* 

1 

1 

{ FE, FD, ! EF, DF, ! 

i 

! FB, F7 ! BF, 7F ! 

1 1 < 

« 

+ — + — + - 

1 » 1 

4* — 4* — 4* — 4- — 4* — 4* — 4* — * 4* — 4* 

! PADDL3 

1 

! PADDL5 ! PADDL7 ! 

1 • < 

1 

1 t f 

! PADDL2 

1 

{ PADDL4 ! PADDL6 ! 

< 1 < 

1 

1 1 1 

•4-~4--4-~4™4—4—+~4---4- 

! STR IG1 

i 

JSTRIG2 ! STR I 03 ! 

< 1 < 

1 

+- 

« 1 « 

•4— 4— 4-*4~4~ ■+~4~ +-4- 


Figure 11-5 ATARI Keyboard Controller Var iab le/Reg ister Value 

Tab le 


Front Panel Connectors as I/O Ports 

The three pages that follow show how some of the pins in the front 
panel (game controller) connectors can be used as general I/O pins. 


Hardware Information 


P I A (6520 / 6820) 

Out: TTL levels/ 

In : TTL levels/ 


1 load 
1 load 


For more information refer 
to 6520 chip manual. 
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Port A Circuit (typical): 


6520 


port 


220 


X 


001 


' jack 


Port B Circuit (typical): 

+5 

4. 7K 


6520 


(B > 


Port 


-AAAn 1 |jac k 

220 001 


1 5 

• • • 

• • < 

6 9 

Male connector/ FRONT view 

Pin 8 = Ground 

Pin 7 = Vcc 8+5v #) 

Note: 50mA maximum 
total external drain 
on power supply allowed 




''Trigger*' Port Circuit (typical): 


CTI A Trig 



II 

001 


Jack 


Software Information 

6520 PIA: (This also pertains to all of the following: **) 

Port A control (address D302) 


7 

6 

5 

4 

3 

2 

1 

0 

1 0 

0 

1 

1 

1 

1 X 

1 0 

0 


Write this into this register 


Port A Data/Data direction addres 
ing control 

0 = Data Direction is at D300 

1 = data is at D300 


Port A data direction (address D300) 


7 6 5 4 3 2 1 0 



X 

X 

X 

X 

X 

X 

X 

Write this into this register 

i 

u 

k - 

LJ 

k J 

M 

M 

k i 




Data direction control 
for Port A 


1 = Out 
0 = In 
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Port A data (address D300) 
7 6 5 4 3 2 1 0 


Read or Write this register 


4 3 2 1 4 3 2 1 

v x v ^ J 

Jack 2 Jack 1 

Pin Numbers 


Port B Control (address D303) 


0 

0 

1 

1 

1 

X 

0 

0 


6520 P I A: 

Port B Control (address D303) 


7 

6 

5 

4 

3 

2 

1 

0 


1 0 

1 

1 

1 

1 X 1 

1 0 

0 I 


Port 


write this into this register 

B Data/Data direction 

addressing control 

0 = D301 contains data 

d irec t i on 

1 = $D301 contains 


Port B data direction (address D301 ) 
7 6 5 4 3 2 1 



write this into this register 

data direction control for Port B 

1 « Out 
0 = In 


Port B data (address D301 ) 

7 6 5 4 3 2 1 0 


4 3 2 1 4 3 2 1 

V _ J V ^ V 

Jack 4 J ack 3 

Pin Numbers 


Four "Trigger” ports: 


D01G, D01 1 / D012i D 013 


7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

0 

0 

0 

0 



n 


Read this port 

Trigger Value 
D010 = Port 1 Pin 
DO 13 = Port 4 pin 


6 

6 
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Other Miscellaneous Software Information 


1). The OS sets up all PIA ports as inputs during 
initial i zation. 

2>. The OS usually reads the above once per television frame 
(during 

vert ical-b lank > into RAM as follows: 


Data Base Name 
STICKO 


Address 
0278 7 


Data 

6 5 4 3 2 


Pins S 

Jac k 1# pins 4, 3 , 2 , 
if 10053,7 


STICK! 

0729 

STICK2 

027A 

STICKS 

027B 

STRIGO 

0284 

STRIG1 

0285 

STRIG2 

0286 

STRIG3 

0287 

PADDL1 

0270 


3 2 



0 

0 

0 

0 

0 

0 

□ 


7 

6 

5 

4 

3 

2 

1 

0 

E 

X 

X 

X 

X 

X 

X 

X 1 


Jack 2 
Jack 3 
Jac k 4 
Jack 1 

Jack 2 
Jack 3 
Jac k 4 

Jack 1 


PADDL3 

0272 

Jac k 

2 , 

Pin 5 

PADDL5 

0274 

Jac k 

3 , 

Pin 5 

PADDL7 

0276 

Jac k 

4, 

Pin 5 

PADDLO 

0271 

Jac k 

1, 

Pin 9 

PADDL2 

0273 

Jack 

2 . 

Pin 9 

PADDL4 

0275 

Jac k 

3 . 

P in 9 

PADDL 6 

0277 

Jack 

4, 

Pin 9 

Figure 11-6 

Using Front Panel Connectors As 

I/O Ports: Pin 


Pins 4, 3, 2, 1 
Pins 4, 3, 2, 1 
Pins 4, 3, 2# 1 
Pin 6 

Pin 6 
Pin 6 
P in 6 

Pin 5 


Function Tables 

* Pins 5 and 9 are read through the paddle controller circuitry 
a nominal value of 7 indicates that the pin is high (or floating) 
and a nominal value of 228 indicates that the pin is pulled low. 
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Appendix A 


CIO COMMAND BYTE VALUES 


The following hex values are known to be legitimate CIO commands 


Most handlers: 

03 ~ OPEN 

05 — GET RECORD 

07 — GET CHARACTERS 

09 — PUT RECORD 

OB — PUT CHARACTERS 

OC — CLOSE 

OD — GET STATUS 


Display Handler only: 

11 — FILL 

12 — DRAW 


Diskette File Manager only: 

20 — RENAME 

21 — DELETE 

22 — FORMAT 

23 — LOCK 

24 — UNLOCK 

25 — POINT 

26 — NOTE 
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Shown below 
01 ( 001 ) — 

80 (128) — 

81 (129) — 

82 (130) — 

83 (131) — 

84 (132) — 

85 (133) — 

86 (134) — 

87 (135) — 

88 (136) — 

89 (137) — 
8A (138) — 
8B (139) — 
8C (140) — 
8D (141) — 
8E (142) — 
8F (143) — 

90 (144) — 

91 (145) -- 

92 (146) — 

93 (147) — 

AO (160) — 
A1 (161) — 
A2 (162) — 
A3 (163) — 
A4 (164) — 
A5 (165) — 
A6 (166) — 
A7 (167) 

A8 (168) — 
A9 (169) — 
AA (170) — 
AB (171) — 


- CIO STATUS BYTE VALUES 


are the known CIO STATUS BYTE values. 

OPERATION COMPLETE (NO ERRORS) 

C BREAK 1 KEY ABORT 

IOCB ALREADY IN USE (OPEN) 

NON-EXISTENT DEVICE 

OPENED FOR WRITE ONLY 

INVALID COMMAND 

DEVICE OR FILE NOT OPEN 

INVALID IOCB NUMBER (Y reg only) 

OPENED FOR READ ONLY 

END OF FILE 

TRUNCATED RECORD 

DEVICE TIMEOUT (DOESN'T RESPOND) 

DEVICE NAK 

SERIAL BUS INPUT FRAMING ERROR 

CURSOR out-of-range 

SERIAL BUS DATA FRAME OVERRUN ERROR 

SERIAL BUS DATA FRAME CHECKSUM ERROR 

DEVICE DONE ERROR 

BAD SCREEN MODE 

FUNCTION NOT SUPPORTED BY HANDLER 
INSUFFICIENT MEMORY FOR SCREEN MODE 

DISK DRIVE # ERROR 
TOO MANY OPEN DISK FILES 
DISK FULL 

FATAL DISK I/O ERROR 
INTERNAL FILE # MISMATCH 
FILE NAME ERROR 
POINT DATA LENGTH ERROR 
FILE LOCKED 

COMMAND INVALID FOR DISK 
DIRECTORY FULL (64 FILES) 

FILE NOT FOUND 
POINT INVALID 
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Appendix C 


SIO STATUS BYTE VALUES 


Shown below 

01 ( 001 > — 

8A (138) — 
8B (139) — 
8C (140) — 
8£ (142) — 
8F (143) — 
90 (144) — 


are the known SIO STATUS BYTE hexadecimal values. 

OPERATION COMPLETE (NO ERRORS) 

DEVICE TIMEOUT (DOESN'T RESPOND) 

DEVICE NAK 

SERIAL BUS INPUT FRAMING ERROR 
SERIAL BUS DATA FRAME OVERRUN ERROR 
SERIAL BUS DATA FRAME CHECKSUM ERROR 
DEVICE DONE ERROR 
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Appendix D — ATASCII CODES 



0X 

2X 

4X 

6X 

8X 

AX 

CX 

EX 

00 

□ 

Space 

§ 

□ 





01 

O 

1 

A 

a 





02 

D 

If 

B 

b 





03 

a 

# 

C 

c 





04 

a 

$ 

D 

d 





05 

a 

Q. 

O 

E 

e 





06 

a 

& 

F 

f ' 





07 

a 

i 

G 

g 





08 

e 

( 

H 

h 





09 

b 

) 

I 

i 





0A 

a 

* 

J 

j 





0B 

s 

+ 

K 

k 





0C 

a 

/ 

L 

1 





0D 

s 

- 

M 

m 





0E 

B 

• 

N 

n 





0F 

a 

/ 

0 

o 





10 

B 

0 

P 

P 





11 

B 

1 

Q 

q 





12 

Q 

2 

R 

r 





13 

O 

3 

S 

s 





14 

a 

4 

T 

t 





15 

B 

5 

U 

u 





16 

n 

6 

V 

V 





17 

Q 

7 

w 

w 





18 

a 

8 

X 

X 





19 

a 

9 

Y 






1A 

o 

• 

• 

z 






IB 

ESC 

• 

9 

c 

E3 

EOL 




1C 

a 

< 

\ 

wm 

E5^e 




ID 

o 

= 

i 

CLEAR 




BELL 

IE 

a 

:> 

/\ 

BACKSP 

Ski 



BS&R 

IF 

Q 

? 

— 

TAB 




m . r 
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DISPLAY CODES (ATASCII) 
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Appendix F 


KEYBOARD CODES (ATASCII) 


CTRL SHIFT & SHIFT LOWER 


LOWER 


00 

t 

20 

20 

Cspac e> 

21 

40 

e 

35 


60 

A 

22 

01 

A 

3F 

21 

i 

IF 

41 

A 

3F 


61 

a 

3F 

02 

B 

15 

22 

H 

IE 

42 

B 

15 


62 

b 

15 

03 

C 

12 

23 

# 

1A 

43 

C 

12 


63 

c 

12 

04 

D 

3A 

24 

* 

18 

44 

D 

3A 


64 

d 

3A 

05 

E 

2A 

25 

7. 

ID 

45 

E 

2A 


65 

e 

2A 

06 

F 

38 

26 

& 

IB 

46 

F 

38 


66 

f 

38 

07 

0 

3D 

27 


33 

47 

0 

3D 


67 

9 

3D 

08 

H 

39 

28 

< 

30 

48 

H 

39 


68 

h 

39 

09 

I 

OD 

29 

) 

32 

49 

I 

OD 


69 

i 

OD 

OA 

J 

01 

2A 

* 

07 

4A 

J 

01 


6A 

J 

01 

OB 

K 

05 

2B 

+ 

06 

4B 

K 

05 


6B 

k 

05 

OC 

L 

00 

2C 

9 

20 

4C 

L 

00 


6C 

1 

00 

OD 

M 

25 

2D 

- 

OE 

4D 

M 

25 


6D 

m 

25 

OE 

N 

23 

2E 

m 

22 

4E 

N 

23 


6E 

n 

23 

OF 

0 

08 

2F 

/ 

26 

4F 

0 

08 


6F 

o 

08 

10 

P 

OA 

30 

0 

32 

50 

P 

OA 


70 

P 

OA 

11 

0 

2F 

31 

1 

IF 

51 

G 

2F 


71 

q 

2F 

12 

R 

28 

32 

2 

IE 

52 

R 

28 


72 

r 

28 

13 

S 

3E 

33 

3 

1A 

53 

S 

3E 


73 

s 

3E 

14 

T 

2D 

34 

4 

18 

54 

T 

2D 


74 

t 

2D 

15 

U 

OB 

35 

5 

ID 

55 

U 

OB 


75 

u 

OB 

16 

V 

10 

36 

6 

IB 

56 

V 

10 


76 

V 

10 

17 

W 

2E 

37 

7 

33 

57 

W 

2E 


77 

U) 

2E 

18 

X 

16 

38 

8 

35 

58 

X 

16 


78 

X 

16 

19 

Y 

2B 

39 

9 

30 

59 

Y 

2B 


79 

y 

2B 

1A 

Z 

17 

3A 


02 

5A 

Z 

17 


7A 

z 

17 

IB 

<esc> 

1C 

3B 

i 

OD 

5B 

C 

20 


7B 

i 

02 

1C 

A Cup> 

OE 

3C 

< 

36 

5C 

\ 

06 


7C 

t 

t 

OF 

ID 

"'••Cdoam> 

OF 

3D 

ss 

OF 

5D 

1 

22 


7D 

<c lear> 

36 

IE 

'"‘••Clef t> 

06 

3E 

> 

37 

5E 

A 

07 


7E 

<back> 

34 

IF 

"'■•Cr ight>07 

3F 

? 

26 

5F 

— 

OE 


7F 

<tab> 

2C 

80- 

■9A / i \ 

00- 

1A 



9F s 

<Itab 

> 

2C 




9B 

Creturn) 

► and 

''•3 

OCi 1A 


AO-FC 

/{\ 

20- 

•7C 



9C 

s<del> 

34 




FD A 2 


1E 




9D 

s-Cinser t 

;>37 




FE 

<Idel 

> 

34 




9E 

A Ctab> 

2C 




FF ''••Cinsert 

>37 





<clear> s< or A < 

<return> : : = <return> or s<return> or ''Creturn> 

<esc> : : = <esc> or s<esc> or A <esc> 

<space> ::= <space> or s<space> or A <space> 

Where: s as a prefix indicates CSHIFT3. 

as a prefix indicates CCTRL3. 

/{\ as a prefix indicates ATARI key inverse active. 
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Appendix G — PRINTER CODES (ATASCII) 


Character set for "normal" mode printing: 


20 

<space> 

40 

@ 

60 

% 

21 

I 

41 

A 

61 

a 

22 

fl 

42 

B 

62 

b 

23 

# 

43 

C 

63 

c 

24 

♦ 

44 

D 

64 

d 

25 

7. 

45 

E 

65 

e 

26 

& 

46 

F 

66 

f 

27 

t 

47 

G 

67 

9 

28 

( 

48 

H 

68 

h 

29 

> 

49 

I 

69 

i 

2A 

* 

4A 

J 

6A 

J 

2B 

+ 

4B 

K 

6B 

k 

2C 

$ 

4C 

L 

6C 

1 

2D 


4D 

M 

6D 

m 

2E 


4E 

N 

6E 

n 

2F 

/ 

4F 

0 

6F 

0 

30 

0 

50 

P 

70 

P 

31 

1 

51 

Q 

71 

4 

32 

2 

52 

R 

72 

r 

33 

3 

53 

S 

73 

s 

34 

4 

54 

T 

74 

t 

35 

5 

55 

U 

75 

u 

36 

6 

56 

V 

76 

V 

37 

7 

57 

w 

77 

Ijj 

38 

8 

58 

X 

78 

X 

39 

9 

59 

Y 

79 

y 

3A 


5A 

Z 

7A 

z 

3B 

i 

5B 

t 

7B 

< 

3C 

< 

5C 

\ 

7C 

1 

t 

3D 

ss 

5D 

1 

7D 

> 

3E 

> 

5E 

A 

7E 


3F 

? 

5F 


7F 

<space> 


Note: The following codes print differently 
the ATASCII definition. 


00 

through 

IF print 

b lank. 

60 

prints 

' instead 

of 

"diamond". 

7B 

prints 

{ instead 

of 

"spade". 

7D 

prints 

> instead 

of 

“clear". 

7E 

prints 

~ instead 

of 

"backspace" 

7F 

prints 

blank instead 

of "tab". 
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Character set for “sideways" mode printing: 




40 


60 

G 



41 

A 

61 

A 



42 

B 

62 

B 



43 

C 

63 

C 



44 

D 

64 

D 



45 

E 

65 

E 



46 

F 

66 

F 



47 

G 

67 

G 



48 

H 

68 

H 



49 

I 

69 

I 



4A 

J 

6A 

J 



4B 

K 

6B 

K 



4C 

L 

6C 

L 



4D 

M 

6D 

M 



4E 

N 

6E 

N 



4F 

0 

6F 

0 

30 

0 

50 

P 

70 

P 

31 

1 

51 

G 

71 

G 

32 

2 

52 

R 

72 

R 

33 

3 

53 

S 

73 

S 

34 

4 

54 

T 

74 

T 

35 

5 

55 

U 

75 

U 

36 

6 

56 

V 

76 

V 

37 

7 

57 

w 

77 

w 

38 

8 

58 

X 

78 

X 

39 

9 

59 

Y 

79 

Y 

3A 

; 

5A 

Z 

7A 

Z 

3B 

i 

5B 

c 

7B 

C 

3C 

< 

5C 

\ 

7C 

\ 

3D 

ss 

5D 

3 

7D 

3 

3E 

> 

5E 

<up> 

7E 

<up> 

3F 


5F 

deft> 

7F 

<left> 


Note: the following codes print differently than defined by 
the ATASCII definition. 

00 through 2F print blank. 

5E prints "up arrow" instead of 
5F prints "left arrow" instead of 

60 through 7F repeats 40 through 5F instead of proper set. 
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SCREEN MODE CHARACTERISTICS 


Mode 

Hor i z . 

Vert. 

Vert. 

Colors 

Data 

Color 

Memory 


# 

Posit. 

W/0 Sp 

W Sp 


Va 1 ue 

Reg. 

Reqd. 

(split) 

(full ) 

0 

40 

24 

— 

2 

bac kgd. 

BAK 

992 

992 






OO-FF 

PF 2 








it 

PF 1* 



1 

20 

24 

20 

5 

bac kgd. 

BAK 

674 

672 






00-3F 

PF 0 








40-7F 

PF 1 








80-BF 

PF 2 








CO-FF 

PF 3 



2 

20 

12 

10 

5 

backgd. 

BAK 

424 

420 






00-3F 

PF 0 








40-7F 

PF 1 








80-BF 

PF 2 








CO-FF 

PF 3 



3 

40 

24 

20 

4 

0 

BAK 

434 

432 






1 

PF 0 








2 

PF 1 








3 

PF 2 



4 

80 

48 

40 

2 

0 

BAK 

694 

696 






1 

PF 0 



5 

80 

48 

40 

4 

0 

BAK 

1174 

1176 






1 

PF 0 








2 

PF 1 








3 

PF 2 



6 

160 

96 

80 

2 

0 

BAK 

2174 

2184 






1 

PF 0 



7 

160 

96 

80 

4 

0 

BAK 

4190 

4200 






1 

PF 0 








2 

PF 1 








3 

PF 2 



8 

320 

192 

160 

2 

0 

PF 2 

8112 

8138 






1 

PF 1* 



9 

80 

192 

— 

1 

Note 2 



8138 

10 

80 

192 

— 

9 

0 

PM 0 


8138 






1 

PM 1 








2 

PM 2 








3 

PM 3 








4 

PF 0 
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5 PF 1 

6 PF 2 

7 PF 3 

8 BAK 

9 BAK 

A BAK 

B BAK 

C PF O 

D PF 1 

E PF 2 

p pp 3 

11 80 192 — 16 Note 3 8138 


Notes : 

* Uses color of PF 2# lum of PF 1. 

2 Uses color of BAK# lum of data value (*0-F>. 

3 Uses color of data value <*0-F># lum of BAK. 

PF x ::= Playfield color register x. 

PM x Player/Missile Graphics color register x. 

BAK : : * Background color register (also known as PF 4). 

The default values for the color registers are shown below: 

BAK = *00 

PFO * *28 

PF1 = *CA 
PF2 = *94 

PF3 = *46 
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The form of a color register byte is shown below: 


7 6 5 4 3 2 1 0 

+-+ — K-+ — 

« color ! lum «G! 

4- — b — h-4- — b — h— + — h — *■ 

Where: color (hex values) lum 

minimum luminance 


( increasing 

luminance ) 

< 

I 

I 
I 

maximum luminance 

8 = blue 

9 * light blue 
A = turquoise 
B * green-blue 
C - green 

D = yellow-green 
E « orange-green 
F » light orange 


gray 

light orange 

orange 

red orange 

pink 

purp le 

purp le-b lue 

blue 


190 


OPERATING SYSTEM C016555 — Appendix H 



Appendix I 


SERIAL BUS ID AND COMMAND SUMMARY 


Serial bus device IDs 

Floppy diskettes D1-D4 $31-34 

Printer PI $40 

RS-232-C R1-R4 $50-53 


Serial bus control codes 


ACK 

NAK 

COMPLETE 

ERR 


$41 ('AM 
$4E ( 'N' ) 
$43 ( 'CM 
$45 ('EM 


Serial bus command codes 


READ 

- $52 

WRITE 

- $57 

STATUS 

- $53 

PUT(no check) 

- $50 

FORMAT 

- $21 

READ ADDRESS 

- $54 

READ SPIN 

- $51 

MOTOR ON 

- $55 

VERIFY SECTOR 

- $56 


('RM Disk 

( 'W M Printer/Disk 

( 'SM Printer/Disk 

('PM Disk 

('!') Disk 

( 'TM 

('QM Disk 

('UM Disk 

('VM Disk 
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Appendix J 

— ROM 

VECTORS 


The fixed 

address 

OS ROM JMP 

vectors are shown below; at each 

address is 

a JMP 

instruction 

to the indicated routine. 

Name 

Addr 

Reference 

Function 

DISKIV 

E450 

* 

Diskette Handler ini tial i zation 

DSKINV 

E453 

5. 4. 2 

Diskette Handler entry. 

CIOV 

E456 

5. 2 

CIO utility entry. 

SIOV 

E459 

9. 3 

SIO utility entry. 

SETVBV 

E45C 

6. 7. 2 

Set System Timers routine. 

SYSVBV 

E45F 

6. 3 

Stage 1 VBLANK entry. 

XITVBV 

E462 

6. 3 

Exit VBLANK entry. 

SIOINV 

E465 


SIO utility ini tial i zation. 

SENDEV 

E468 

* 

Send enable routine. 

INTINV 

E46B 

» 

Interrupt Handler initialization 

CIOINV 

E46E 

# 

CIO utility ini tial i zation. 

BLKBDV 

E471 

3. 1. 1 

Blackboard mode entry. 

WAR MS V 

E474 

7. 

Warmstart ( C SYSTEM. RESET 3 > entry 

COLDSV 

E477 

7. 

Coldstart (power-up) entry. 

RBLOKV 

E47A 

# 

Cassette-r ead block entry. 

CSOPIV 

E47D 

* 

Cassette-OPEN input entry. 


* These vectors are for OS internal use only. 

The fixed address Floating Point Package ROM routine entry point 
addresses are shown below; complete descriptions of the 
corresponding routines are provided in Section 8. 


AFP 

D800 

ASCII to FP convert. 

FASC 

D8E6 

FP 

to ASCII convert. 

IFP 

D9AA 

Integer to FP convert. 

FPI 

D9D2 

FP 

to integer convert. 

FA DD 

DA66 

FP 

add. 

FSUB 

DA60 

FP 

sub tract. 

FMUL 

DADB 

FP 

multiply 

FDI V 

DB28 

FP 

divide. 

LOG 

DECD 

FP 

base e logarithm. 

LOG 10 

DED1 

FP 

base 10 logarithm. 

EXP 

DDCO 

FP 

base e exponentiation. 

EXP10 

DD CC 

FP 

base 10 exponentiation 

PLYEVL 

DD40 

FP 

polynomial evaluation. 

ZFRO 

DA44 

Clear FRO. 

ZF1 

DA46 

Clear FP number. 

FLDOR 

DD89 

Load FP number. 

FLDOP 

DD8D 

Load FP number. 

FLD1R 

DD98 

Load FP number. 

FLD1P 

DD9C 

Load FP number. 

FSTOR 

DDA7 

Store FP number. 

FSTOP 

DDAB 

Store FP number. 

FMOVE 

DDB6 

Move FP number. 
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The base addresses of the Handler vectors for 
handlers are shown below: 


Screen Editor (E) E400 
Display Handler <S) E410 
Keyboard Handler <K) E420 
Printer Handler (P) E430 
Cassette Handler <C) E440 


See Section 5 for the format of the entry for 
The 6502 Computer interrupt vector values are 


Function 

Address 

Value 

NMI 

FFFA 

E7B4 

RESET 

FFAC 

E477 

IRQ 

FFFE 

E6FE 


the resident 

each Handler. 

shown below: 
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Appendix K 


DEVICE CHARACTERISTICS 


This appendix describes the physical charac ter ist ics of the 
devices that interface to the ATARI 400 and ATARI 800 Home 
Computers. Where applicable/ data capacity/ data transfer 
rate/ storage format/ SIO interface/ and cabling will be 
detailed. 


KEYBOARD 

The keyboard input rate is limited by the OS keyboard reading 
procedure to be 60 characters per second. The code for each key 
is shown in Table 5-4. The keyboard hardware has no buffering and is 
rate-limited by the debounce algorithm used. 


DISPLAY 

The television screen display generator has many capabilities 
that are not used by the Display Handler (as described in Section 
5 and shown in Appendix H). There are additional display modes/ 
object generators/ hardware display scrolling/ and many other 
features that are described in the ATARI Home Computer 
Hardware Manual. 

Since all display data is stored in RAM/ the display data update 
rate is limited primarily by the software routines that generate 
and format the data and access the RAM. The generation of the 
display from the RAM is accomplished by the ANTIC and CTIA or GTIA 
chips using Direct Memory Access (DMA) to access the RAM data. 

The internal storage formats for display data for the various 
modes are detailed in the ATARI Home Computer Hardware 
Manual. 


ATARI 410 PROGRAM RECORDER 

The ATARI 410 Program Recorder has the following charac ter i st i c s : 
DATA CAPACITY: 

100 characters per C-60 tape ( unf ormatted ) . 

DATA TRANSFER RATES: 

* 600 Baud (60 characters per second) 

*Note: The OS has the ability to adjust to different tape speeds 
(447 - 895 Baud). 
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STORAGE FORMAT: 


Tapes are recorded in 1/4 track stereo format at 1 7/8 inches per 
second. The tape can be recorded in both directions! where tracks 
1 and 2 are side A left and right; and tracks 3 and 4 are side B 
right and left (industry standard). On each side# the left 
channel (1 or 4) is used for audio and the right channel (2 and 
3) is used for digital information. 

The audio channel is recorded the normal way. The digital channel 
is recorded using the POKEY two-tone mode producing FSK data at 
up to 600 baud. The MARK frequency is 5327 Hz and the SPACE 
frequency is 3995 Hz. The transmission of data is asynchronous 
byte serial as seen from the computer; POKEY reads or writes a 
bit serial FSK sequence for each byte* in the following order: 


1 start bit (SPACE) 
data bit 0 — 
data bit 1 ! 

+- 0 = SPACE/ 1 = MARK, 

data bit 6 ! 

data bit 7 -+ 

1 stop bit (MARK) 

The only control the computer has over tape motion is motor 
start/stop; and this only if the PLAY button is pressed by the 
user. In order for recording to take place# the user must press 
both the REC and PLAY buttons on the cassette. The computer has 
no way to sense the position of these buttons# nor even if an 
ATARI 410 Program Recorder is cabled to the computer# so the user must 
be careful when using this device. 


SIO INTERFACE 

The cassette device utilizes portions of the serial bus hardware# 
but does not follow any of the protocol as defined in Section 9. 


ATARI 820CTM3 40-COLUMN IMPACT PRINTER 

The ATARI 820 Printer has the following character istics: 


DATA CAPACITY: 

40 characters per line (normal printing) 

29 characters per line (sideways printing) 


DATA TRANSFER RATES: 
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Bus rate: xx characters per second. 

Print time (burst): xx characters per second. 
Print time (average): xx characters per second. 


STORAGE FORMAT: 

3 7/8 inch wide paper. 

5X7 dot matrix# impact printing. 


Normal format — 

40 characters per line. 

6 lines per inch (vertical). 

12 characters per inch (horizontal). 


Sideways format — 

29 characters per line. 

6 lines per inch (vertical). 

9 characters per inch (horizontal). 


SIO INTERFACE 

The controller serial bus ID is $40. 

The controller supports the following SIO commands (see Section 
for more information regarding the Handler and Section 9 for a 
general discussion of bus commands): 


GET STATUS 

The computer sends a command frame of the format shown below: 

Device ID = $40. 

Command byte » $53. 
auxiliary 1 = doesn't matter, 
auxiliary 2 = doesn't matter. 

Checksum « checksum of bytes above. 

The printer controller responds with a data frame of the format 
shown earlier in this appendix as part of the GET STATUS 
discussion. 


PRINT LINE 

The computer sends a command frame of the format shown below: 

Device ID * $40. 

Command byte = $57. 
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auxiliary 1 = doesn't matter. 

auxiliary 2 - $4E for normal print or $53 for sideways. 
Checksum = checksum of bytes above. 

The computer sends a data frame of the format shown below: 

Leftmost character of line (column 1). 

Next character of line (column 2). 


Rightmost character of line (column 40 or 29). 

Checksum byte. 

Note that the data frame size is variable/ either 41 or 30 bytes 
in length* depending upon the print mode specified in the command 
frame. 


ATARI 810 DISK DRIVE 

The ATARI 810CTM3 Disk Drive has the following charac ter istics: 
DATA CAPACITY: 

720 sectors of 128 bytes each (Disk Handler format). 

709 sectors of 125 data bytes each (Disk File Manager format). 


DATA TRANSFER RATES: 

Bus rate: 1920 characters per second. 

Seek time: 5. 25 msec, per track + 10 to 210 msec. 
Rotational latency: 104 msec maximum (288 rpm). 


STORAGE FORMAT: 

5 1/4 inch diskette/ soft sectored by the controller. 

40 tracks per diskette. 

18 sectors per track. 

128 bytes per sector. 

Controlled by National INS1771-1 format ter /control ler chip. 
Sector sequence per track is: 18/ 1/ 3/ 5/ 7/ 9 , 11/ 13/ 15/ 

17/ 2/ 4/ 6» 8, 10/ 12/ 14/ 16 

SIO INTERFACE 

The controller serial bus IDs range from $31 (for 'Dl'> to $34 
(for 'D4 ' ) . 
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The controller supports the following SIO commands (see earlier 
in this Appendix for information about the Diskette Handler and 
Section 9 for a general discussion of bus commands): 


GET STATUS 

The computer sends a command frame of the format shown below: 

Device ID ® *31-34. 

Command byte « *53. 
auxiliary 1 = doesn't matter, 
auxiliary 2 = doesn't matter. 

Checksum = checksum of bytes above. 

The diskette controller responds with a data frame of the format 
shown earlier in this Appendix as part of the STATUS REQUEST 
discussion. 


PUT SECTOR (WITH VERIFY) 


The computer sends a command frame of the format shown below: 

Device ID = *31-34 
Command byte = *57. 

auxiliary 1 = low byte of sector number, 
auxiliary 2 = high byte of sector number (1-720). 

Checksum = checksum of bytes above. 

The computer sends a data frame of the format shown below: 


128 data bytes. 
Checksum byte. 


The diskette 
sector# then 
frame data, 
operat i on. 


controller writes the frame data to the specified 
reads the sector and compares the content with the 
The COMPLETE byte value indicates the status of the 


PUT SECTOR (NO VERIFY) 

The computer sends a command frame of the format shown below: 

Device ID = *31-34 
Command byte = *50. 

auxiliary 1 = low byte of sector number, 
auxiliary 2 = high byte of sector number (1-720). 

Checksum = checksum of bytes above. 

The computer sends a data frame of the format shown below: 
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128 data bytes. 
Checksum byte. 


The diskette controller writes the frame data to the specified 
sector/ then sends a COMPLETE byte value that indicates the 
status of the operation. 


GET SECTOR 

The computer sends a command frame of the format shown below: 

Device ID = $31-34 
Command byte » $52. 

auxiliary 1 = low byte of sector number, 
auxiliary 2 = high byte of sector number (1-720). 

Checksum * checksum of bytes above. 

The diskette controller sends a data frame of the format shown below: 

128 data bytes. 

Checksum byte. 


FORMAT DISKETTE 

The computer sends a command frame of the format shown below: 

Device ID = $31-34 
Command byte = $21. 
auxiliary 1 = doesn't matter, 
auxiliary 2 = doesn't matter. 

Checksum - checksum of bytes above. 

The diskette controller completely formats the diskette (generates 40 
tracks of 18 soft sectors per track with the data portion of each 
sector equal to all zeros) and then reads each sector to verify 
its integrity. A data frame of 128 bytes plus checksum is 
returned in that the sector numbers of all bad sectors (up to a 
maximum of 63 sectors) are contained/ followed by two consecutive 
bytes of $FF. If there are no bad sectors on the diskette the first 
2 bytes of the data 
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Appendix L — OS DATA BASE VARIABLE FUNCTIONAL DESCRIPTIONS 


CENTRAL DATA BASE DESCRIPTION 


This appendix provides detailed information for those variables 
in the OS data base that can be altered by the user. Remaining 
variables are provided narrative descriptions. Information on the 
variables is presented in a multiple access scheme: Lookup 
tables are referenced to a common set of narratives# that is 
itself ordered by function. 

Variable descriptions are referenced by a label called a variable 
identifier (VID) number. The label comprises a single letter 
followed by a number. A different letter is assigned for each 
major functional area being described, and the numbers are 
assigned sequentially within each functional area. Those 
variables that are not considered to be of interest to any user 
are flagged with an asterisk <*) after their names. The data base 
lookup tables provided are: 

1. Functional grouping — index to the function narrative and 
descriptions of variables# giving VID and variable name. 

2. Alphabetic list of names — giving VID of description. 

3. Address ordered list — giving VID of description. 

Item 1# the functional grouping index# starts on the next page# 
the other two lookup tables are at the end of Appendix L. 
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FUNCTIONAL INDEX TO DATA BASE VARIABLE DESCRIPTIONS 


A. Memory configuration 
A1 MEMLO 
A2 MEMTOP 
A3 APPMHI 
A4 RAMTOP 
A5 RAMSIZ 


B. Text/graphics screen 

Cursor control 
B1 CRSINH 
B2 ROWCRSi COLCRS 
B3 OLDRQW# OLDCOL 
B4 TXTROW/ TXTCOL 


Screen margins 
B5 LMARGN 
B6 RMARGN 

Color control 

B7 PCOLRO - PC0LR3 
B8 COLORO ~ C0L0R4 

Text scrolling 
B9 SCRFLG* 

Attract mode 
BIO ATRAC T 
Bll CGLRSH* 

B12 DRKMSK* 

Tabb ing 

B13 TABMAP 

Logical text lines 
B14 LOGMAP* 

Bi 5 LQGCOL* 

Split screen 
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B16 BOTSCR* 


FILL/DRAW function 
B17 FILDAT 
BIB FILFLG* 

B19 NEW 5R0W*/ NEWCOL* 
B20 HOLD4* 


B21 ROWINC*# CGLINC* 
B22 DELTAR*/ DELTAC* 
B23 COUNTRY 
B24 ROWAC*, COLAC* 
B25 ENDPT* 


Displaying control characters 

Escape (display following control char) 
B26 ESCFLG* 

Display control characters mode 
B27 DSPFLG 


Bit mapped graphics 
B28 DMASK* 

B29 SHF AMT* 
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Internal working variables 
B30 H0LD1* 

B31 H0LD2* 

B32 H0LD3* 

B33 TMPCHR* 

B34 DSTAT* 

B35 DINDEX 
B3& SAVMSC 
B37 OLDCHR* 

B38 OLDADR* 

B39 ADRESS* 

B40 MLTTMP /OPNTMP /TOADR* 
B41 SAVADR /FRMADR* 

B42 BUFCNT* 

B43 BUFSTR* 

B44 SWPFLG* 

B45 INSDAT* 

B46 TMPROW*, TMPCOL* 

B47 TMPLBT* 

B48 SUBTMP* 

B49 TINDEX* 

B50 BITMSK* 

B51 LINBUF# 

B52 TXTMSC 
B53 TXTOLD* 
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Internal character code conversion 
B54 ATACHR 
B55 CHAR* 


C. Disk Handler 
Cl BUFADR* 
C2 DSKTIM* 


D. Cassette (part in SIO part in Handler) 

Baud rate determinat ion 
D1 CBAUDL*, CBAUDH* 

D2 TIMFLG* 

D3 TIMER1** TIMER2* 

D4 ADDCOR* 

D5 TEMPI* 

D6 TEMP 3* 

D7 SAVIO* 

Cassette mode 
D8 CASFLG* 


Cassette buffer 
D9 CASBUF* 

DIO BLIM* 

Dll BPTR* 

Internal working variables 
D12 FEOF* 

D13 FTYPE* 

D14 WMODE* 

D15 FREQ* 


E. Keyboard 

Key reading and debouncing 
El CHI* 

E2 KEYDEL* 

E3 CH 
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Special functions 


Start/stop 
E4 SSFLAG 

C BREAK 3 
E5 BRKKEY 

C SHIFT 3 / C CONTROL 3 lock 
E6 SHFLOK 
E7 HOLDC Ha- 

Autorepeat 
E8 SR T I MR* 

Inverse video 
E9 INVFLG 

Console switches ( CSELECT3 , CSTART3, and COPTION3) 


F. Printer 

printer-buffer 

FI PRNBUF* 

F2 PBUFSZ* 

F3 PBPNT* 

Internal working variables 
F4 PTEMP* 

F5 PTIMOT* 


G. Central I/O routine (CIO) 
User call parameters 

G1 IOCB 
G2 ICHID 
G3 ICDNO 
G4 ICCOM 
G5 ICSTA 
G6 ICBALf ICBAH 
G7 ICPTL/ ICPTH 
G8 ICBLLi ICBLH 
G9 ICAX 1 » ICAX2 
GIO ICSPR 

Device status 
Gil DVSTAT 

device table 
G12 HATABS 
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CIO/Handler interface Parameters 


G 13 ZIOCB ( IOCBAS) 

G14 ICHIDZ 

G15 ICDNOZ 

G16 ICCOMZ 

G17 ICSTAZ 

G18 ICBALZ» ICBALH 

G19 ICPTL 1 , ICPTHZ 

G20 ICBLLZ/ ICBLHZ 

G21 ICAX 1 Z# ICAX2Z 

G22 ICSPRZ ( IC IDNO/ C IOCHR ) 

Internal working variables 
G23 ICCQMT* 

G24 IC IDNO* 

G25 C IOCHR* 


H. Serial I/O routine (SIO) 


User call parameters 

HI DCB control block 
H2 DDEVIC 
H3 DUN IT 
H4 DCOMND 
H5 DSTATS 
H6 DBUFLO* DBUFHI 
H7 DTIMLO 
H8 DBYTLO, DBYTHI 
H9 DAUX1 # DAUX2 

Bus sound control 
HIO SOUNDR 

Serial bus control 

Retry logic 
HI 1 CRETRY* 

H12 DRETRY* 

Checksum 

HI 3 CHKSUM* 

HI 4 CHKSNT* 

HI 5 NOCKSM* 


206 


OPERATING SYSTEM C016555 — Appendix L 



Data buffering 


General buffer control 

H16 BUFRLO*, BUFRHI* 
HI 7 BFENLO*, BFENHI* 


Command frame output buffer 
H18 CDEVIC* 

H19 CCOMND* 

H20 CAUXi*/ CAUX2* 

Receive/transmit data buffering 
H21 BUFRFL* 

H22 RECVDN* 

H23 TEMP* 

H24 XMTDON* 

SIQ timeout 
H25 TIMFLG* 

H26 CDTMV1* 

H27 CDTMA1* 


Internal working variables 
H28 STACKP* 

H29 TSTAT* 

H30 ERRFLG* 

H31 STATUS* 

H32 SSKCTL* 


J. ATARI controllers 
Joysticks 

J 1 STICKO - STICK3 
J2 STRIGO - STRIG3 

Padd les 

J3 PADDLO - PADDL7 
J4 PTRIGO - PTRIG7 

Paddle controllers 
J8 STICKO - STICK3 
J9 STRIGO - STRIG3 


K. Disk file manager 
K1 FMSZPG* 

K2 ZBUFP* 

K3 ZDRVA* 

K4 ZSBA* 

K5 ERRNO* 
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L. Disk utilities (DOS) 
LI DSKUTL* 


M. Floating point package 
Ml FRO 
M2 FRE* 

M3 FR1 
M4 FR2* 

M5 FRX* 

M6 EEXP* 

M7 NSIGN* 

M8 ESIGN* 

M9 FCHRFLG* 

MIO DIGRT* 

Mil CIX 
Ml 2 INBUFF 
M13 ZTEMPi* 

M14 ZTEMP4* 

Ml 5 ZTEMP3* 

M16 FLPTR 
M17 FPTR2* 

M18 LBPR1* 

M19 LBPR2* 

M20 LBUFF 
M21 PLYARG* 

M22 FPSCR/FSCR* 

M23 FPSCR1/FSCR1* 

M24 DEGFLG/RADFLG* 


N. Pouier-Up and System Reset 
RAM sizing 

N1 RAMLO*# TRAMSZ* 

N2 TSTDAT* 


Diskette/cassette-boot 
N3 DOS INI 
N4 CKEY* 

N5 CASSBT* 

N6 CAS INI 
N7 BOOT?* 

N8 DFLAGS* 

N9 DBSECT* 

NIO BOOT AD* 

Environmental control 
Nil COLDST 
N12 DOSVEC 
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CS RESET 3 

N13 WARMST 


P. Interrupts 
PI CRITIC 
P2 POKMSK 

System Timers 

Real-time clock 
P3 RTCL0K 

System Timer 1 
P4 CDTMV1 
P5 CDTMA1 

System Timer 2 
P6 CDTMV2 
P7 CDTMA2 

System Timers 3-5 

PS CDTMV3* CDTMV4# CDTMV5 
P9 CDTMF3# CDTMF4» CDTMF5 

RAM-interrupt vectors 

NMI-interrup t vectors 
PIO VDSLST 
Pll WBLKI 
P12 WBLKD 


IRQ-interrup t vectors 
P13 VIMIRQ 
P14 VPRCED 
P15 VINTER 
P 16 VBREAK 
P17 VKEYBD 
P 18 VSERIN 
P19 VSEROR 
P20 VSEROC 

P21 VTIliRl* VTIMR2/ VTIMR4 

Hardware register updates 
P22 SDMCTL 
P23 SDLSTL, SDLSTH 
P24 OPR I OR 
P25 CHACT 
P26 CHBAS 
P27 PCOLRx, COLOR x 
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Internal working variable 
P28 INTEMP* 


R. User areas 

Rl (unlabeled) 
R2 USAREA 


This appendix contains descriptions of many of the data base 
variables# descriptions are included for all of the user- 
accessible variables and for some of the "internal" variables as 
well. Those variables that are not considered to be normally of 
interest to any user are flagged with an asterisk (*) after their 
names; the other variables can be of interest to one or more of 
the following classes of users: 


o 

End user. 


0 

Game developer. 


0 

Applications programmer. 

o 

System utility 

writer. 

0 

Language processor developer 

o 

Device Handler 

Wr i ter. 


Each variable is specified by its system equate file name 
followed by its address (in hex) and the number of bytes reserved 
in the data base (in decimal)/ in the following form: 

<name> £<address>/ <si ze>3 

For example: 

MEMLO C02E7/21 

Note that most word (2 byte) variables are ordered with the least 
significant byte at the lower address. 
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A. MEMORY CONFIGURATION 


See Section 4 for a general discussion of memory dynamics and 
section 7 for details of system ini tial i zation. 


A1 MEMLO C02E7/21 — User-free memory low address 

MEMLO contains the address of the first location in the free 
memory region. The value is established by the OS during power-up 
and system reset initial i zat ion and is never altered by the OS 
thereaf ter. 


A2 MEMTOP C02E5/ 23 — User-free memory high address 

MEMTOP contains the address of the first non-useable memory 
location above the free memory region. The value is established 
by the OS during power-up and system reset initialization; and 
then is re-established whenever the display is opened* based upon 
the requirements of the selected graphics mode. 


A3 APPMHI COOOE # 21 — User-free memory screen lower limit 

APPMHI is a user-controlled variable that contains the address 
within the free memory region below which the Display Handler cannot 
go in setting up a display screen. This variable is 
initialized to zero by the OS at power-up. 


A4 RAMTOP* C006A* 1 3 — Display Handler top of RAM address <MSB> 

RAMTOP permanently retains the RAM top address that was contained 
in TRAMSZ (as described in N1 ) for the Display Handler's use. The 
value is set up as part of Handler ini tial i zat ion. 


A5 RAMSIZ C02E4* 1 3 — Top of RAM address (MSB only) 

RAMSIZ permanently retains the RAM top address that was contained 
in TRAMSZ (as described in Nl). 
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B. TEXT/GRAPHICS SCREEN 


See Section 5 for a discussion of the text and graphics screens 
and their Handlers. 


Cursor Control 

For the text screen and split-screen text window there is a 
visible cursor on the screen which shows the position of the next 
input or output operation. The cursor is represented by inversing 
the video of the character upon which it resides; but the cursor 
can be made invisible, at the user's option. The graphics screen 
always has an invisible cursor. 

The cursor position is sensed by examining data base variables 
and can be moved by altering those same variables; in addition, 
when using the Screen Editor, there are cursor movement control 
codes that can be sent as data (as explained in Section 5). 


B1 CRSINH C02F0, 13 — Cursor display inhibit flag 

When CRSINH is zero, all outputs to the text screen will be 
followed by a visible cursor (inversed character); and when 
CRSINH is nonzero, no visible cursor will be generated. 

CRSINH is set to zero by power-up, the C SYSTEM. RESET 3 or C BREAK 3 keys 
or an OPEN command to the Display Handler or Screen Editor. 

Note that altering CRSINH does not cause the visible cursor to 
change states until the next output to the screen; if an 
immediate change to the cursor state is desired, without altering 
the screen data, follow the CRSINH change with the output of 
CURSOR UP, CURSOR DOWN, or some other innocuous sequence. 


B2 ROWCRS C0054, 13 and COLCRS C0055, 23 — Current cursor 
position 

ROWCRS and COLCRS define the cursor location (row and column, 
respectively) for the next data element to be read from or 
written to the main screen segment. When in split-screen mode, 
the variables TXTROW and TXTCOL define the cursor for the text 
window at the bottom of the screen as explained in B4 below. 

The row and column numbering start with the value zero, and 
increase in increments of one to the number of rows or columns minus 
1; with the upper left corner of the screen being the origin (0,0). 

ROWCRS is a single-byte variable with a maximum allowable value 
of 191 (screen modes 8-11); COLCRS is a 2-byte variable with a 
maximum allowable value of 319 (screen mode 8). 
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B3 OLDROW COOSA# 13 and OLDCOL C005B# 23 — Prior cursor position 


OLDROW and OLDCOL are updated from ROWCRS and COLCRS before every 
operation. The variables are used only for the DRAW and FILL 
operat ions. 


B4 TXTROW C0290# 1 3 and TXTCOL C029i*23 — Split-screen text cursor 
position 

TXTROW and TXTCOL define the cursor location (row and column* 
respectively) for the next data element to be read from or 
written to the split-screen text window. 

The row and column numbering start with the value zero# and 
increase in increments of one to 3 and 39# respectively* with the 
upper left corner of the split-screen text window being the origin 
( 0 * 0 ). 


Screen Margins 

The text screen and split-screen text window have user-al terab le 
left and right margins that define the normal domain of the text 
cursor. 


B5 LMARGN C0052*13 — Text column left margin 

LMARGN contains the column number (0-39) of the text screen left 
margin* the text cursor will remain on or to the right of the 
left margin as a result of all operations# unless the cursor 
column variable is directly updated by the user (see B2 and B4 
above). The default value for LMARGN is 2 and is established upon 
power-up or system reset. 


B6 RMARGN C0053*13 — Text column right margin 

RMARGN contains the column number (0—39) of the text screen right 
margin* the text cursor will remain on or to the left of the 
right margin as a result of all operations* unless the cursor 
column variable is directly updated by the user (see B2 and B4 
above). The default value for RMARGN is 39 and is established 
upon power-up or system reset. 
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Color Control 


As part of the stage 2 VBLANK process (see Section 6)# the values of 
nine data base variables are stored in corresponding hardware 
color control registers. The color registers are divided into two 
groups: the p layer/missi le colors and the playfield colors. The 

playfield color registers are utilized by the different screen modes 
as shown in Appendix H. The p lay er/mi ss i 1 e color registers are not 
used by the standard OS. 


B7 PCOLRO - PC0LR3 C02C0/ 43 — Play er/miss i le graphics colors 

Each color variable is stored in the correspond ing hardware 
register as shown below: 


PCOLRO C02C03 
PCOLR1 C02C13 
PC0LR2 C02C23 
PC0LR3 C02C33 


COLPMO C DO 123 
COLPM1 CD0133 
C0LPM2 CD0143 
C0LPM3 CDG153 


Each color variable has the format shown below: 
7 6 5 4 3 2 1 0 
S color i lum ' x I 


See Appendix H for information regarding the color and luminance 
field values. 


B8 C0L0R0 - C0L0R4 C02C5, 53 — Playfield colors 


Each color variable is stored in the c orrespond ing hardware 
register as shown below: 


C0L0R0 C02C43 
COLOR 1 C02C53 
C0L0R2 C02C63 
COLORS C02C73 
C0L0R4 C02C83 


COLPFO CD0163 
COLPFi CD0173 
C0LPF2 CD0183 
C0LPF3 CD0193 
COLBK CD01A3 


Each color variable has the format shown below: 
7 6 5 4 3 2 1 0 
! color { lum « x I 

•+• — i — 


See Appendix H for information regarding the color and luminance 
field values. 
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Text Scrolling 

The text screen or split-screen text window “scrolls” upward 
whenever one of the two conditions shown below occurs: 

o A text line at the bottom row of the screen extends past the 
right margin. 

o A text line at the bottom row of the screen is terminated by 
an EOL. 

Scrolling has the effect of removing the entire logical line that 
starts at the top of the screen and then moving all subsequent 
lines upward to fill in the void. The cursor will also move 
upward if the logical line deleted exceeds one physical line. 


B9 SCRFLG* C02BB#13 — Scroll flag 

SCRFLG is a working variable that counts the number of physical 
lines minus 1 that were deleted from the top of the screen/ 
since a logical line ranges in size from 1 to 3/ SCRFLG ranges 
from O to 2. 


Attract Mode 

Attract mode is a mechanism that protects the television screen 
from having patterns "burned into” the phosphors due to a fixed 
display being left on the screen for extended periods of time. 

When the computer is left unattended for more than 9 minutes# the 
color intensities are limited to 50 percent of maximum and the 
hues are continually varied every 8.3 seconds. Pressing any 
keyboard data key will be sufficient to remove the attract mode 
for 9 more minutes. 

As part of the stage 2 VBLANK process# the color registers from 
the data base are sent to the corresponding hardware color 
registers# before they are sent# they undergo the following 
transf or mat ion: 

hardware register = database variable XOR COLRSH AND DRKMSK 

Normally COLRSH = *00 and DRKMSK = *FE# thus making the above 
calculation a null operation# however# once attract mode becomes 
active# COLRSH * the content of RTCLOK+1 and DRKMSK ■ *F6# that 
has the effect of modifying all of the colors and keeping their 
luminance always below the 50 percent level. 

Since RTCLQK+1 is incremented every 256/60 of a second and 
since the least significant bit of COLRSH is of no consequence# a 
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color/lum change will be effected every 8.3 seconds (512/60). 


BIO ATRACT C004D* 13 — Attract mode timer and flag 

ATRACT is the timer (and flag) that controls the initiation and 
termination of attract mode. Whenever a keyboard key is pressed/ 
the keyboard IRQ service routine sets ATRACT to zero/ thus 
terminating attract mode; the CBREAK3 key logic behaves 
accordingly. As part of the stage 1 VBLANK process/ ATRACT is 
incremented every 4 seconds; if the value exceeds 127 (after 9 
minutes without keyboard activity)/ the value of ATRACT will 
be set to $FE and will retain that value until attract mode is 
terminated. 

Since the attract mode is prevented and terminated by the OS 
based only upon keyboard activity* some users can want to reset 
ATRACT based upon Atari-controller event detection* 
user-controlled Serial I/O bus activity or any other signs of 
life. 


Bll COLRSH* C004F/13 — Color shift mask 

COLRSH has the value $00 when attract mode is inactive* thus 
effecting no change to the screen colors; when attract mode is 
active* COLRSH contains the current value of the timer variable 
middle digit (RTCLOK+1). 


B12 DRKMSK* C004E, 13 — Dark (luminance) mask 

DRKMSK has the value $FE when attract mode is inactive* which does not 
alter the luminance; and has the value $F6 when attract mode 
is active* which forces the most significant bit of the luminance 
field to zero* thus guaranteeing that the luminance will never 
exceed 50 percent. 


Tabbing 

See Section 5 for a discussion of the use of tabs in conjunction 
with the Screen Editor. 


B13 TABMAP C02A3* 153 — Tab stop setting map 

The tab settings are retained in a 15-byte (120 bit) map* where a 
bit value of 1 indicates a tab setting; the diagram below shows 
the mapping of the individual bits to tab positions. 
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TABMAP+O 


7 6 5 4 3 2 1 0 

+ + + + 4. 4. + 4. 4. 

! 0 « 1 i 2 ! 3 ! 4 ! 5 • 6 < 7 < 

4. 4 4 4 4 4 4 4 4 

5 8 5 9 1 10! 11} 121 13! 141 15! 4-1 

4 4 4 4 4 4 4 4 4 

! ! 


4 4 4 4 4 4 4 4 4 

5112! 113! 114! 115! 116 5117! 118! 119! +14 

4 — . — — 4 — — — 4 ~ — — . 4 — . — — 4 — — — 4 — — — 4 — — ~ 4 _ — — 4 

Whenever the Display Handler or Screen Editor is opened# this map 
is initialized to contain the value of $01 in every byte# thus 
providing the default tab stops at 7# 15# 23# etc. 


Logical Text Lines 

The text screen is invisibly divided into logical lines of text# 
each comprising from one to three physical lines of text. The 
screen is initialized to 24 logical lines of one physical line 
each# but data entry and/or data insertion can increase the size 
of a logical line to two or three physical lines. 


B14 LOGMAP* C02B2# 43 — Logical line starting row map 

The beginning physical line number for each logical line on the 
screen is retained in a four byte <32 bit) map# where a bit value 
of one indicates the start of a logical line# the diagram below 
shows the mapping of the individual bits to physical line (row) 
numbers. 


7 6 5 4 3 2 1 0 
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4 4 
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The map bits are all set to 1 whenever the text screen is 
opened or cleared. From that point# the map is updated as 
logical lines are entered# edited and deleted from the screen. 
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B15 LOGCQL* C0063#13 — Cur sor /log ical line column number 


LOGCOL contains the logical-line column number for the current 
cursor position; note that a logical line can comprise up to 
three physical lines. This variable is for the internal use of 
the Display Handler. 


Split Screen 

The Display Handler and Screen Editor together support the 
operation of a split-screen mode (see Section 5) in which the main 
portion of the screen is in one of the graphics modes and is 
controlled by the Display Handler# and there are 4 physical lines in 
the text window at the bottom of the screen which is controlled by th 
Screen Editor. 


B16 BOTSCR* C02BF#13 — Text screen lines count 

BOTSCR contains the number of lines of text for the current 
screen: 24 for mode O or 4 for a split-screen mode. The Handler 
also uses this variable as an indication of the split-screen 
status; tests are made for the specific values 4 and 24. 


DRAW/FILL Function 

The DRAW function line drawing algorithm is shown below 
translated to the PASCAL language from assembly language. 


NEWROW 

: = ROWCRS; NEWCOL : = COLCRS; 


DELTAR 
ROW INC 

:= ABS (NEWROW-OLDROW); 

:« SIGN (NEWROW-OLDROW); 

< +1 or 

-1 > 

DELTAC 

COLINC 

: = ABS (NEWCOL-OLDCOL); 

:= SIGN (NEWCOL-OLDCOL); 

< +1 or 

-1 > 

ROWAC : 
ROWCRS 

= 0; COLAC : = 0; 

:= OLDROW; COLCRS :* OLDCOL; 


COUNTR := MAX ( DELTAC # DELTAR ) ; 
ENDPT :■ COUNTR; 

IF COUNTR » DELTAC 




THEN ROW AC : = ENDPT DIV 2 
ELSE COLAC : = ENDPT DIV 2; 


WHILE COUNTR > 0 DO 
BEGIN 
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RON AC : = ROWAC + DELTAR; 

IF ROWAC >= ENDPT 
THEN 

BEGIN 

ROWAC : = ROWAC - ENDPT; 

ROWCRS :* ROWCRS + ROWINC 
END; 

COLAC :« COLAC + DELTAC; 

IF COLAC >= ENDPT 
THEN 

BEGIN 

COLAC : - COLAC - ENDPT; 

COLCRS :» COLCRS •+■ COLINC 
END; 

PLOT__POINT ; < point defined by ROWCRS and COLCRS > 
IF FILFLG O 0 THEN FILL_LINE; 

COUNTR : = COUNTR - 1 


END; 

The FILL function algorithm <FILL_LINE above) is described briefly 
Section 5. 


B17 FILDAT C02FD* 13 — Fill data 

FILLDAT contains the fill region data value as part of the calling 
sequence for a FILL command as described in Section 5. 


B18 FILFLG* C02B7, 13 — Fill flag 

FILFLG indicates to the shared code within the Display Handler 
whether the current operation is FILL (FILFLG O 0) or DRAW 
(FILFLG * 0). 


B19 NEWROW* C0060* 1 3 and NEWCOL* 10061,23 — Destination point 

NEWROW and NEWCOL are initialized to the values in ROWCRS and 
COLCRS* which represent the destination endpoint of the DRAW/FILL 
command. This is done so that ROWCRS and COLCRS can be altered 
during the performance of the command. 


B20 HQLD4* C02BC, 13 — Temporary storage 
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H0LD4 is used to save and restore the value in ATACHR during the 
FILL process; ATACHR is temporarily set to the value in FILDAT to 
accomplish the filling portion of the command. 


B21 ROW INC* C0079* 1 3 and COLINC* C007A* 13 — Row/column 
increment /decrement 

ROWINC and COLINC are the row and column increment values; they 
are each set to +1 or -1 to control the basic direction of line 
drawing. ROWINC and COLINC represent the signs of NEWROW - 
ROWCRS and NEWCOL - COLCRS, respectively. 


B22 DELTAR* 10076*13 and DELTAC* C0077* 23 — Delta row and delta 
column 

DELTAR and DELTAC contain the absolute values of NEWROW - ROWCRS 
and NEWCOL — COLCRS* respectively; together with ROWINC and 
COLINC* they define the slope of the line to be drawn. 


B23 COUNTR* C007E* 23 — Draw iteration count 

COUNTR initially contains the larger of DELTAR and DELTAC* that 
is the number of iterations required to generate the desired 
line. COUNTR is then decremented after every point on the line is 
plotted* until it reaches a value of zero. 


B24 ROWAC* C0070* 23 and COLAC* 10072*23 — Accumulators 

ROWAC and COLAC are working accumulators that control the row-and 
column-point plotting and increment (or decrement) function. 


B25 ENDPT* C 0074* 23 — Line length 

ENDPT contains the larger of DELTAR and DELTAC* and is used in 
conjunction with ROWAC/COLAC and DELTAR/DELTAC to control the 
plotting of line points. 


Displaying Control Characters 

Often it is useful to have ATASCII control codes (such as CLEAR* 
CURSOR UP* etc), displayed in their graphic forms instead of 
having them perform their control function. This display 
capability is provided in two forms when outputting to the Screen 
Editor: 1) a data content form in which a special character (ESC) 
precedes each control character to be displayed and 2) a mode 
control form. 
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Escape (Display Following Control Character) 

Whenever an ESC character is detected by the Screen Editor# the 
next character following this code is displayed as data# even if 
it would normally be treated as a control code; the EOL code is 
the sole exception. It is always treated as a control code. The 
sequence ESC ESC will cause the second ESC character to be 
displayed. 


B26 ESCFLG* C02A2# 13 — Escape flag 

ESCFLG is used by the Screen Editor to control the escape 
sequence function; the flag is set (to $80) by the detection of 
an ESC character (♦IB) in the data stream and is reset (to 0) 
following the output of the next character. 


Display Control Characters Mode 

When it is desired to display ATASCII control codes other than 
EOL in their graphics form# but not have an ESC character 
associated with each control code* a display mode can be 
established by setting a flag in the data base. This capability 
is used by language processors when displaying high-level 
language statements# that can contain control codes as data 
elements. 


B27 DSPFLG C02FE#13 — Display control characters flag 

When DSPFLG is nonzero# ATASCII control codes other than EOL are 
treated as data and displayed on the screen when output to the 
Screen Editor. When DSPFLG is zero# ATASCII control codes are 
processed normally. 

DSPFLG is set to zero by Power-up and CSYSTEM. RESET3. 


Bit-Mapped Graphics 

A number of temporary variables are used by the Display Handler 
when handling data elements (pixels) going to or from the screen 
of interest here are those variables that are used to control th 
packing and unpacking of graphics data# where a memory byte 
typically contains more than one data element (for example# 
screen mode 8 contains 8 pixels per memory byte). 


B28 DMASK* C02A0, 13 — Pixel location mask 
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DMASK is a mask that contains zeros for all bits that do not 
correspond to the specific pixel to be operated upon* and 
1 's for all bits that do correspond. DMASK can contain 
the values shown below in binary notation: 


11111111 — 

screen 

modes 

1 and 2, 

one pixel per byte. 


11110000 — 
00001111 

screen 

modes 

9-11, two 

pi xels 

per byte. 


11000000 — 
00110000 
00001100 
00000011 

screen 

modes 

3, 5 and 

7, four 

pixels per 

byte. 

10000000 — 
01000000 

00000010 

00000001 

screen 

modes 

4, 6 and 

8, eight 

pixels per 

byte 


B29 SHF AMT* C006F, 13 — Pixel just if ication 

SHFAMT indicates the amount to shift the r ight-justif ied pixel 
data on output/ or the amount to shift the input data to right 
justify it on input. The value is always the same as for DMASK 
prior to the justif ication process. 


Internal Working Variables 
B30 HOLD1* £0051/13 — Temporary storage 
B31 H0LD2* C029F/13 — Temporary storage 
B32 H0LD3* C029D/13 — Temporary storage 
B33 TMPCHR* C0050/13 — Temporary storage 
B34 DSTAT* C004C/13 — Display status 
B35 DINDEX C0057/13 — Display mode 

DINDEX contains the current screen mode obtained from the low 
order four bits of the most recent OPEN AUX1 byte. 


B36 SAVMSC C 0058, 23 — Screen Memory Address 

SAVMSC contains the lowest address of the screen data region, the 
data at that address is displayed at the upper left corner of the 
screen. 
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B37 OLDCHR* C005D, 13 


Cursor character save/restore 


OLDCHR retains the value of the character under the visible text 
cursor; this variable is used to restore the original character 
value u/hen the cursor is moved. 


B38 OLDADR* C005E# 23 — Cursor memory address 

OLDADR retains the memory address of the current visible text 
cursor location; this variable is used in conjunction with OLDCHR 
(B37) to restore the original character value when the cursor is 
moved. 


B39 ADRESS* C 0064# 23 — Temporary storage 

B40 MLTTMP /OPNTMP /TOADR* C 0066# 23 — Temporary storage 

B41 SAVADR/FRMADR* t 0068# 23 — Temporary storage 


B42 BUFCNT* C006B#13 — Screen Editor current logical line size 


B43 BUFSTR* C006C# 23 — Temporary storage 


B44 SWPFLG* C007B, 13 — Split-screen cursor control 

In split-screen mode# the graphics cursor data and the text 
window cursor data are frequently swapped as shown below in order 
to get the variables associated with the region being accessed 
into the ROWCRS-OLDADR variables. 


ROWCRS B2 
COLORS B2 
DINDEX B35 
SAVliSC B36 
OLDROW B3 
OLDCOL B3 
OLDCHR B37 
OLDADR B38 


TXTRQW B4 
TXTCOL B4 
TINDEX B49 
TXTMSC B52 
TXTOLD B53 

•i <1 

ii it 

ii it 


SWPFLG is used to keep track of what data set is currently in the 
ROWCRS-OLDADR region; SWPFLG is equal to *FF when split-screen 
text window cursor data is in the main region# otherwise SWPFLG 
is equal to O. 


B45 INSDAT* C007D# 13 — Temporary storage 
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B46 TMPROW* C02B8, 13 and TMPCOL* C02B9, 23 — Temporary storage 
B47 TMPLBT* £02A1,13 — Temporary storage 
B48 SUBTMP* C029E, 13 — Temporary storage 

B49 TINDEX* C0293, 13 — Split screen text window screen mode 

TINDEX is the split-screen text window equivalent of DINDEX and is 
always equal to zero when SWPFLG is equal to zero (see B44). 


B50 BITMSK* C006E,13 — Temporary storage 
B51 LINBUF* C 0247 # 403 — Physical line buffer 

LINBUF is used to temporarily buffer one physical line of text 
when the Screen Editor is moving screen data. 

B52 TXTMSC C 0294, 23 — Split screen memory address 

TXTMSC is the split-screen text window version of SAVMSC (B36). 

See B44 for more information. 


B53 TXTOLD* C0296* 63 — Split screen cursor data 
See B44 for more information. 


Internal Character Code Conversion 


Two variables are used to retain the current character being 
processed (for both reading and writing); ATACHR contains the 
value passed to or from CIO, and CHAR contains the internal code 
corresponding to the value in ATACHR. Because the hardware does 
not interpret ATASCII characters directly, the transf ormat ions 
shown below are applied to all text data read and written: 


ATASCII 

INTERNAL 

CODE 

CODE 

00- IF 

40- 5F 

20-3F 

00- IF 

40-5F 

20-3F 

60- 7F 

60-7F 

80-9F 

CO-DF 
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AO-BF 

CO-DF 

EO-FF 


80-9F 

AO-BF 

EO-FF 


See P26 for more information. 


B54 ATACHR E02FB»13 — Last ATASCII character or plot point 

ATACHR contains the ATASCII value for the most recent character 
read or written* or the value of the graphics point. This 
variable can also be considered to be a parameter of the 
FILL/DRAW commands* as the value in ATACHR will determine the 
line color when a DRAW or FILL is performed. 


B55 CHAR* C02FA* 13 — Internal character code 

CHAR contains the internal code value for the most recent 
character read or written. 


C. DISKETTE HANDLER 

See Section 5 for a discussion of the resident Diskette Handler. 


Cl BUFADR* £0015* 23 — Data buffer pointer 

BUFADR acts as temporary page zero pointer to the current 
diskette buffer. 


C2 DSKTIM* £0246*13 — Disk format operation timeout time 

DSKTIM contains the timeout value for SIQ calling sequence 
variable DTIMLQ (see Section 9). DSKTIM is set to 160 (which 
represents a 171-second timeout) at ini tial i zat ion time* and is 
updated after each diskette status request operation. It contains the 
value returned in the third byte of the status frame (see Section 
5). Note that all diskette operations other than format have a 
fixed (7) second timeout* established by the Diskette Handler. 


D. CASSETTE 

See Section 5 for a general description of the Cassette Handler. The 
cassette uses the Serial I/O bus hardware* but does not conform with 
the Serial I/O bus protocol as defined in Section 9. Hence* the Serial 
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I/O utility (SIO) has cassette specific code within it. Some variables 
in this subsection are utilized by SIO and some by the Cassette 
Handler. 


Baud Rate Determinat ion 

The input baud rate is assumed to be a nominal 600 baud# but will 
be adjusted# if necessary# by the SIO routine to account for 
drive-motor variations# stretched tape# etc. The beginning of 
every cassette record contains a pattern of alternating 1 's and 
zeros that is used solely for speed correction# by measuring the 
time to read a fixed number of bits# the true-receive baud rate 
is determined and the hardware adjusted accordingly. Input baud 
rates ranging from 318 to 1407 baud can theoret ical ly be handled 
using this technique. 

The input baud rate is adjusted by setting the POKEY counter that 
controls the bit sampling period. 


Di CBAUDL* C02EE# 1 3 and CBAUDH* C02EF#13 — Cassette baud rate 

Initialized to 05CC hex# which represents a nominal 600 baud. 
After baud rate calculation# these variables will contain POKEY 
counter values for the corrected baud rate. 


D2 TIMFLG* C0317#13 — Baud rate determinat ion timeout flag 

TIMFLG is used by SIO to timeout an unsuccessful baud rate 
determinat ion. The flag is initially set to 1# and if it attains a 
value of zero (after 2 seconds) before the first byte of the cassette 
record has been read# the operation will be aborted. See also H24. 


D3 TIMER1* C030C# 23 and TIMER2* C0310# 23 — Baud rate timers 

These timers contain reference times for the beginning and end of 
the fixed bit pattern receive period. The first byte of each 
timer contains the then current vertical line counter value read 
from ANTIC# and the second byte of each timer contains the then 
current value of the least significant byte of the OS real time 
clock (RTCLOK+2). 

The difference between the timers is converted to raster pair 
counts and is then used to perform a table lookup with 
interpolat ion to determine the new values for CBAUDL and CBAUDH. 


D4 ADDCOR* C030E# 13 — Interpolation adjustment variable 
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ADDCOR is a temporary variable used for the interpolation 
calculation of the above computation. 


D5 TEMPI* C0312* 23 — Temporary storage 


D6 TEMP3* C0315*13 — Temporary storage 


D7 SAVIQ* E0316* 13 — Serial in data detect 

SAVIO is used to retain the state of SKSTAT CD20F3 bit 4 (serial 
data in); it is used to detect (and is updated after) every bit 
arrival. 


Cassette Mode 


D8 CASFLG* C030F* 13 — Cassette I/O flag 

CASFLG is used internally by SIO to control the program flow 
through shared code. A value of zero indicates that the current 
operation is a standard Serial I/O bus operation* and a nonzero 
value indicates a cassette operation. 


Cassette Buffer 


D9 CASBUF* C03FD, 1313 — Cassette record buffer 


CASBUF is the 
and unpacking 
cassette-boot 
in the buffer 


buffer used by the Cassette Handler for the packing 
of cassette-record data* and by the ini tial i zation 
logic. The format for the standard cassette record 
is shown below: 


76543210 

4— 4-4 -4-4- 4- 4-4-4 

so i o i o i o i: 

CASBUF40 

4-4-4-4-4-4-4-4-4 

JO 1 0 1 0 1 0 11 

+ 1 

! control byte ! 

42 

4-4-4-4-4— 4-4-4-4 

I 128 i 

+3 

= data = 

! bytes S 

4130 


+ _ + _4._ + _ + _ + _ + — f._+ 


See Section 5 for an explanation of the standard cassette— record 
format. 
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DIO BLIM* C 028 A, 13 — Cassette record data size 

BLIM contains the count of the number of data bytes in the 
current cassette record being read. BLIM will have a value 
ranging from 1 to 128» depending upon the record control byte as 
explained in Section 5. 


Dll BPTR* C003D/13 — Cassette-record data index 

BPTR contains an index into the data portion of the cassette 
record being read or written. The value will range from O to the 
then current value of BLIM. When BPTR equals BLIM then the buffer 
(CASBUF) is full if writing or empty if reading. 


Internal Working Variables 


D12 FEOF* C003F, 13 — Cassette end-of-file flag 

FEOF is used by the Cassette Handler to flag the detection of an 
end of file condition (control byte = $FE). FEOF equal to zero 
indicates that an EOF has not yet been detected/ and a nonzero 
value indicates that an EOF has been detected. The flag is reset 
at every OPEN. 


D13 FTYPE* C003E/13 — Interrecord gap type 

FTYPE is a copy of ICAX2Z from the OPEN command and indicates the 
type of interrecord gap selected; a positive value indicates 
normal record gaps# and a negative value indicates continuous 
mode gaps. 


D14 WMODE* C0289/13 — Cassette read/write mode flag 

WMODE is used by the Cassette Handler to indicate whether the 
current operation is a read or write operation; a value of zero 
indicates read# and a value of $80 indicates write. 


D15 FREQ* £0040/ 13 — Beep count 

FREQ is used to retain and count the number of beeps requested of 
the BEEP routine by the Cassette Handler during the OPEN command 
process. 
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E. KEYBOARD 


See Section 5 for a general description of the Keyboard Handler. 


Key Reading and Debouncing 

The console key code register is read in response to an IRQ 
interrupt that is generated whenever a key stroke is detected by 
the hardware. The key code is compared with the prior key code 
accepted (CHI); if the codes are not identical# then the new code 
is accepted and stored in the key code FIFO (CH> and in the prior 
key code variable (CHI). If the codes are identical# then the new 
code is accepted only if a suitable key debounce delay has 
transpired since the prior value was accepted. 

If the key code read and accepted is the code for CCTRL3 1# then 
the display start/stop flag (SSFLAG) is complemented and the 
value is not stored in the key code FIFO (CH). 

In addition to the reading of the key data# SRTIMR is set to $30 
for all interrupts received (see E8># and ATRACT is set to O 
whenever a new code is accepted (see BIO). 

The Keyboard Handler obtains all key data from CH# whenever a 
code is extracted from that l~byte FIFO# the Handler stores a 
value of $FF to the FIFO to indicate that the code has been read. 
See Section 5 for further discussion of the Keyboard Handler's 
processing of the key codes. 


El CHI* CG2F2#13 — Prior keyboard character code. 

CHI contains the key code value of the key most recently read and 
accepted. 


E2 KEYDEL* C02F1#13 — Debounce delay timer. 

KEYDEL is set to a value of 3 whenever a key code is accepted# 
and is decremented every 60th of a second by the stage 2 VBLANK 
process (until it reaches zero). 


E3 CH C02FC#13 — Keyboard character code FIFO. 

CH is a 1-byte FIFO that contains either the value of the most 
recently read and accepted key code or the value $FF (which 
indicates that the FIFO is empty). The FIFO is normally read by 
the Keyboard Handler, but can be read by a user program. 

Key data can also be stored into CH by the Autorepeat logic as 
explained in the discussion relating to E8. 
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Special Functions 


Star t/Stop 

Display Handler and Screen Editor output to the text or graphics 
mode screen can be stopped and started (without losing any of the 
output data) through the use of the CCTRL3 i key combination. 

Each key depression toggles a flag that is monitored by the above 
mentioned Handlers. When the flag is nonzero# the handlers wait 
for it to go to zero before continuing any output. 


E4 SSFLAG £ 02FF # 1 3 — Start/stop flag 

The flag is normally zero# indicating that screen output is not 
to be stopped. The flag is complemented by every occurrence of 
the CCTRL3 1 key combination by the keyboard IRQ service routine. 

The flag is set to zero upon power-up# C SYSTEM. RESET 3 or £ BREAK 3 
key processing. 


£ BREAK 3 Key 


E5 BRKKEY C0011#13 — CBREAK3 key flag 


BRKKEY is used to indicate that the CBREAK3 key has been pressed. 
The value is normally nonzero and is set to zero whenever the 
CBREAK3 key is pressed. The code that detects and processes the 
£ BREAK 3 condition (flag « O) should set the flag nonzero again. 

BRKKEY is monitored by the following OS routines: Keyboard 
Handler# Display Handler# Screen Editor# Cassette Handler# xx? 
The detection of a £BREAK3 condition during an I/O operation 
will cause the operation to be aborted and a status of $80 to be 
returned to the user. 

The flag is set to nonzero upon Power-up# £ SYSTEM. RESET 3 or upon 
aborting a pending I/O operation. 


£SHIFT3/£CONTROL3 Lock 

The keyboard control has three different modes for code 
generation that apply to the alphabetic keys A through Z: 
1) normal# 2) caps lock# and 3) control lock. 
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In normal mode* all unmodified alphabetic character keys generate 
the lowercase letter ATASCII code ($61-7A). 

In caps lock mode/ all unmodified alphabetic character keys 
generate the uppercase letter ATASCII code ($41-5A). 

In control lock mode/ all unmodified alphabetic character keys 
generate the control letter ATASCII code ($Q1--1A). 

In all three modes# any alphabetic character key that is modified 
(by being pressed in conjunction with the CSHIFT3 or CCTRL3 key) 
will generate the desired modified code. 


E6 SHFLOK C02BE, 13 — Shift/control lock control flag 

SHFLOK normally has one of three values: 

$00 = normal mode (no locks in effect). 

$40 « caps lock. 

$80 = control lock. 

SHFLOK is set to $40 upon Power-up and C SYSTEM. RESET 3 and is 
modified thereafter by the OS only when the C CAPS. LOWER 3 key is 
pressed (either by itself or in conjunction with the CSHIFT3 or 
CCTRL3 key). 


E7 HGLDCH* C007C# 13 — Character holding variable 

HOLDCH is used to retain the current character value prior to the 
C SH I FT 3 /C CONTROL 3 logic process. 


Autorepeat 

The Autorepeat feature responds to the continuous depression of a 
keyboard key by replicating the key code 10 times per second/ 
after an initial 1/2 second delay. The timer variable SRTIMR is 
used to control both the initial delay and the repeat rate. 

Whenever SRTIMR is equal to zero and a key is being held down# 
the value of the key code is stored in the key code FIFO (CH). 
This logic is part of the stage 2 VBLANK process. 


E8 SRTIMR* C022B/13 — Autorepeat timer 

SRTIMR is controlled by two independent processes: 1) the 
keyboard IRQ service routine# which establishes the initial delay 
value and 2) the stage 2 VBLANK routine that establishes the 
repeat rate# decrements the timer and implements the auto repeat 
logic. 
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Inverse Video Control 


The Keyboard Handler allows the direct generation of more than 
half of the 256 ATASCII codes; but codes $80-9A and codes $AO- FC 
can be generated only with the “inverse video mode" active. The 
ATARI key acts as an on/off toggle for this mode# and all 
characters (except for screen editing control characters) will be 
subject to inversion when the mode is active. 


E9 INVFLG C02B6#13 — Inverse video flag 

INVFLG is normally zero# indicating that normal video ATASCII 
codes (bit 7 = 0) are to be generated from keystrokes; whenever INVFLG 
is nonzero# inverse video ATASCII codes (bit 7=1) will be generated. 
The special control codes are exempt from this bit manipulat ion. 

INVFLG is set to zero by power-up and system reset. 

The Keyboard Handler inverts bit 7 of INVFLG whenever the ATARI key 
is pressed; the lower order bits are not altered and are assumed to be 
zero. 

The Keyboard Handler's “exclusive or's“ (XOR's) the ATASCII key data 
with the value in INVFLG at all times; the normal values of $00 and 
$80 thus lead to control of the inverse video bit (bit 7). 


Console Keys: C SELECT 3 # CSTART3# and E0PTI0N3 

The console keys are sensed directly from the hardware 
register CONSOL CD01F3; see the ATARI Home Computer 
Hardware Manual for details. 


F. PRINTER 

See Section 5 for a general description of the Printer Handler. 


Pr inter-Buf f er 


FI PRNBUF* C03C0# 403 — Printer-record buffer 

PRNBUF is the buffer used by the Printer Handler for packing printer 
data to be sent to the device controller. The buffer is 40 bytes long 
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and contains nothing but printer data. 


F 2 PBUFSZ* C001E/13 — Printer-record size 

PBUFSZ contains the size of the Printer-record for the current mode 
selected; the modes and respective sizes (in decimal bytes) are shouin 
beloui: 


Normal 40 

Double width 20 (not currently supported by the device) 
Sideways 29 

Status request 4 


F3 PBPNT* tOOlDi 13 — Printer-buffer index 

PBPNT contains the current index to the Printer-buffer. PBPNT ranges 
in value from zero to the value of PBUFSZ. 


Internal Working Variables 

F4 PTEMP* C001F#13 — Printer Handler temporary data save 

PTEMP is used by the Printer Handler to temporarily save the value of 
a character to be output to the printer. 


F5 PTIMOT* COOIC, 13 — Printer timeout value 

PTIMOT contains the timeout value for SIO calling sequence variable 
DTIMLG (see Section 9); PTIMOT is set to 30 (which represents a 32 
second timeout) at int ial i zation time* and is updated after each 
printer status request operation to contain the value returned in the 
third byte of the status frame (see Section 5). 


G. CENTRAL I/O ROUTINE (CIO) 

See Section 5 for a description of the Central I/O Utility. 
User Call Parameters 
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CIO call parameters are passed primarily through an I/O Control 
Block (IOCB); although additional device status information can be 
returned in DVSTAT, and Handler information is obtained from the 
device table (HATABS). 


I/O Control Block 

IOCB is the name applied collectively to the 16 bytes associated 
with each of the 8 provided control structures# see Section 5. 


G1 IOCB £0340,163 — I/O Control Block 

The label IOCB is the location of the first byte of the first IOCB in 
the data base. For VIDs G2 through G10, the addresses given are for 
IOCB #0 only, the addresses for all of the IOCB's are shown below: 

0340— 034F IOCB #0 

0350-035F IOCB #1 

0360-036F IOCB #2 

0370-037F IOCB #3 

0380-038F IOCB #4 

0390-039F IOCB #5 

03A0-03AF IOCB #6 

03B0-03BF IOCB #7 


G2 ICHID £0340, 1 3 — Handler ID 

See Section 5. Initialized to $FF at power-up and system reset. 


G3 ICDNO £0341, 1 3 — Device number 
See Section 5. 


G4 ICCOM £0342,13 — Command byte 
See Section 5. 


G5 ICSTA £0343,13 — Status 
See Section 5. 


G6 ICBAL, ICBAH £0344,23 — Buffer address 
See Section 5. 
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G7 ICPTL# ICPTH C 0346, 23 — PUT BYTE vector 


See Section 5. Initialized to point to CIO's M IOCB not OPEN" routine 
at power-up and system reset. 


G8 ICBLL# ICBLH C 0348# 23 — Buffer length / byte count 
See Section 5. 

G9 ICAXli 1CAX2 C034A# 23 — Auxiliary information 
See Section 5. 

G10 ICSPR C034C# 43 — Spare bytes for Handier use 

There is no fixed assignment of these four bytes; the Handler 
associated uiith an IOCB can or may not use these bytes. 


Device Status 


GU DVSTAT C02EA# 43 — Device status 

See Section 5 for a discussion of the GET STATUS command. 


Device Table 


G12 HATABS C031A, 383 — Device table 

See Section 9 for a description of the device table. 


CIO/Handler Interface Parameters 


Communicat ion between CIO and a Handler is accomplished using the 
6502 machine registers# and a data structure called the Zero-page 
IOCB (ZIOCB). The ZIOCB is essentially a copy of the particular 
IOCB being used for the current operation. 
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Zero-Page IOCB 


013 Z IOCB < IOCBAS) C 0020, 163 — Zero-page IOCB 

The Zero-page IOCB is an exact copy (except as noted in the 
discussions that follow) of the IOCB specified by the 6502 X 
register upon entry to CIO; CIO copies the outer level IOCB to 
the Zero-page IOCB/ performs the indicated function# moves the 
(possibly altered) Zero-page IOCB back to the outer level IOCB# 
and then returns to the caller. 

Although both the outer level IOCB and the Zero-page IOCB are 
defined to be 16 bytes in size# only the first 12 bytes are moved 
by CIO. 


014 ICHIDZ C002G/13 — Handler index number 
See Section 5. Set to $FF on CLOSE. 


G15 ICDNOZ C0021/13 — Device drive number 
See Section 5. 


016 ICCOHZ C0022/13 — Command byte 
See Section 5. 


017 ICSTAZ C0023# 1 3 — Status byte 
See Section 5. 


018 ICBALZ, ICBALH £0024,23 — Buffer address 

See Section 5. This pointer variable is modified by CIO in the 
course of processing some commands# however/ the original value 
is restored before returning to the caller. 


019 ICPTLZ# ICPTHZ 

See Section 5. Set to point to CIO's “IOCB not OPEN** routine on 
CLOSE. 


020 ICBLLZ# ICBLHZ C 0028# 23 — Buffer length / byte count 

See Section 5. This double-byte variable# which starts out 
representing the buffer length# is modified by CIO in the course 
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of processing some commands; then# before returning to the 
caller# the transaction byte count is stored therein. 


G21 ICAX1Z# 1CAX2Z £002 A# 23 — Auxiliary information 
See Section 5. 


022 ICSPRZ (ICIDNO, CIOCHR) C002C# 43 — CIO working variables 

ICSPRZ and ICSPRZ+1 are used by CIO in obtaining the appropriate 
Handler entry point from the handler's vector table (see Section 9). 

ICSPRZ+2 is also labeled ICIDNO and retains the value of the 6502 X 
register from CIO entry. The X register is loaded from ICIDNO as CIO 
returns to the caller. 

ICSPRZ+3 is also labeled CIOCHR and retains the value of the 6502 A 
register from CIO entry# except for data reading type commands# in 
which case the most recent data byte read is stored in CIOCHR. The 
6502 A register is loaded from CIOCHR as CIO returns to the caller. 


Internal Working Variables 


023 ICCOMT* £0017,13 — Command table index 


ICCOMT is used as an index to CIO's internal 
command byte values to Handler entry offsets 
information). ICCOMT contains the value from 
is greater than $0E# in which case ICCOMT is 


command table# which maps 
(see Section 9 for more 
ICCOMZ except when ICCOMZ 
set to $0E. 


024 ICIDNO* E002E#13 — CIO call X register save/restore 
See 022. 


025 CIOCHR* E002F# 1 3 — CIO call A register save/restore 
See G22. 


H. SERIAL I/O ROUTINE (SIO) 

See Section 9 for discussions relating to SIO. 
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User Call Parameters 

SIO call parameters are passed primarily through a Device Control 
Block; although an additional “noisy bus" option exists that is 
selectable through a separate variable. 


Device Control Block 


HI DCB £0300* 123 — Device Control Block 

DCB is the name applied collectively to the 12 bytes at locations 
0300-030B. These bytes provide the parameter passing mechanism for SIO 
and are described individually below. 

H2 DDE V I C £0300* 1 3 — Device bus ID 
See Section 9. 

H3 DUNIT £0301* II — Device unit number 
See Section 9. 


H4 DCOMND £0302*13 — Device command 
See Section 9. 

H5 DSTATS £0303*13 — Device status 
See Section 9. 

H6 DBUFLO* DBUFHI £0304,23 — Handler buffer address 
See Section 9. 


H7 DTIMLO £0306*13 — Device timeout 
See Section 9. 

H8 DBYTLO, DBYTHI £0308*23 — Buffer length / byte count 
See Section 9. 


! 
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H9 DAUX1<DAUX2 C030A# 23 — Auxiliary information 
See Section 9. 


Bus Sound Control 


H10 SOUNDR C0041# 13 — Quiet/noisy I/O flag 

SOUNDR is a flag used to indicate to SIO u/hether noise is to be 
generated on the television audio circuit when Serial I/O bus 
activity is in progress. SOUNDR equal to zero indicates that 
sound is to be inhibited# and nonzero indicates that sound is to 
be enabled. SIO sets SOUNDR to 3 at power-up and system reset. 


Serial Bus Control 
Retry Logic 

SIO will attempt one complete command retry if the first attempt 
is not error free# where a complete command try consists of up to 
14 attempts to send (and acknowledge) a command frame# followed 
by a single attempt to receive COMPLETE and possibly a data 
frame. 


HI 1 CRETRY* C 0036# 13 — Command frame retry counter 

CRETRY controls the inner loop of the retry logic# that associated 
with sending and receiving an acknowledgement of the command frame. 
CRETRY is set to 13 by SIO at the beginning of every command 
initiation# thus allowing for an initial attempt and up to 13 
additional retries. 


H12 DRETRY* C0037#13 — Device retry counter 

DRETRY controls the outer loop of the retry logic# that 
associated with initiating a command retry after a failure 
subsequent to the command frame acknowledgement. DRETRY is set to 
1 by SIO at entry# thus allowing for an initial attempt and 
1 additional retry. 
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Checksum 


The Serial I/O bus protocol specifies that all command and data 
frames must contain a checksum validation byte; this byte is the 
arithmetic sum (with end-around carry) of all of the other bytes 
in the frame. 


H13 CHKSUM* £0031 , 1 3 — Checksum value 

CHKSUM contains the frame checksum as computed by SIO for all frame 
transfers. 


H14 CHKSNT* £003B, 13 — Checksum sent flag 

CHKSNT indicates to the serial bus transmit interrupt service 
routine whether the frame checksum byte has been sent yet. CHKSNT 
equal to zero indicates that the checksum byte has not yet been 
sent; after the checksum is sent# CHKSNT is then set nonzero. 


H15 NOCKSM* £003C, 13 — No checksum follows data flag 

NOCKSM is a flag used to communicate between the SIO top level 
code and the Serial bus receive interrupt service routine that 
the next input will not be followed by a checksum byte. A value 
of zero specifies that a checksum byte will follow, nonzero specifies 
that a checksum byte will not follow. 


Data Buffering 


General Buffer Control 


H16 BUFRLO* £0032,13 and BUFRHI* £0033,13 -- Next byte address 

BUFRLO and BUFRHI comprise a pointer to the next buffer location 
to be read from or written to. For a data frame transfer, the 
pointer is initially set to the value contained in the SIO call 
parameters DBUFLO and DBUFHI, and is then incremented by the 
interrupt service routines as a part of normal bus data transfer. 
For a command frame transfer, the pointer is set to point to the 
SlO-maintained command frame output buffer. 


H17 BFENLO* £0034,13 and BFENHI* £0035,13 — Buffer end address 

BFENLO/BFENHI form a pointer to the byte following the last frame 
data byte (not including the checksum) to be sent or received. 
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BFENLQ/BFENHI is the arithmetic sum of BUFRLO/BUFRHI plus the 
frame size plus -1. 


Command Frame Output Buffer 

See Section 9 for the command frame format and description. 

H18 CDEVIC* CG23A«13 — Command frame device ID 

CDEVIC is set to the value obtained by adding SIO call parameter 
DDEVIC to DUNIT and subtracting 1. 

H19 CCQMND* C023B#13 — Command frame command. 

CCOMND is set to the value obtained from SIO call parameter 
DCOMND. 

H20 CAUX1* C023C# 1 3 and CAUX2* C023D# 13 — Auxiliary information 

CAUX1 and CAUX2 are set to the values obtained from SIO call 
parameters DAUX1 and DAUX2# respectively. 


Receive/Transmit Data Buffering 


H21 BUFRFL* C0038, 13 — Buffer full flag 

BUFRFL is a flag used by the serial bus receive interrupt service 
routine to indicate when the main portion of a bus frame has been 
received — all but the checksum byte. BUFRFL equal to zero 
indicates that the main portion has not been completely received# 
a nonzero value indicates that the main portion has been 
received. 


H22 RECVDN* C0039#13 — Receive frame done flag 

RECVDN is a flag used by SIO to communicate between the Serial 
bus receive interrupt service routine and the main SIO code. The 
flag is initially set to zero by SIO# and later set nonzero by 
the interrupt service routine after the last byte of a bus frame 
has been received. 


H23 TEMP* C023E# 1 3 ~ SIO 1-byte I/O data 
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TEMP is used to receive 1-byte responses from serial bus 
controllers/ such as ACK, NAK, COMPLETE or ERROR. 


H24 XMTDON* C003A/13 — Transmit frame done flag 

XMTDON is a flag used by SIO to communicate between the Serial 
bus transmit interrupt service routine and the main SIO code. Th 
flag is initially set to zero by SIO/ and later set nonzero by 
the interrupt service routine after the last byte of a bus frame 
has been transmitted. 


SIO Timeout 

SIO uses System Timer 1 to provide the timeout capability for 
various operations initiated internally. See Section 6 for a 
discussion of the capabilities of the System Timers. TIMFLG is 
the flag used to communicate between SIO and the timer initiated 
code pointed to by CDTMA1. 


H25 TIMFLG* C0317/13 — SIO operation timeout flag 

TIMFLG is used to indicate a timeout situation for a bus 
operation . The flag is initially set to 1/ and if it attains a 
value of zero (after the timeout period) before the current 
operation is complete/ the operation will be aborted. See also 
D2. 


H26 CDTMV1* C021S/ 23 — System Timer 1 value 

This 2-byte count takes on various values depending upon the 
operation being timed. See also P4. 


H27 CDTMA1* C0226/ 23 — System Timer 1 address 

This vector always points to the JTIMER routine/ whose only 
function is to set TIMFLG to zero. This vector is initialized by 
SIO before every use, so that System Timer 1 can be used by any 
process that does not use SIO within a timing function. See also 
P5. 
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Internal Working Variables 


H28 STACKP* C0318# 13 — Stack pointer save/restore 

STACKP contains the value of the 6502 SP register at entry to 
SIO#* this is retained to facilitate a direct error exit from an 
SIO subroutine. 


H29 TSTAT* C0319/13 — Temporary status 

TSTAT is used to return the operation status from the WAIT 
routine and will contain one of the SIO status byte values as 
shown in Appendix B. 


H30 ERRFLG* C023F, 13 — I/O error flag 

ERRFLG is used for communication between the WAIT routine and the 
outer level SIO code. ERRFLG is normally zero# but is set to *FF 
when a device responds with an invalid response byte. 


H31 STATUS* C0030#13 — SIO operation status 

STATUS is a zero-page variable that is used within SIO to contain 
the operation status that will be stored to the calling sequence 
parameter variable DSTATS when SIO returns to the caller. 


H32 SSKCTL* C0232#13 — SKCTL copy 

SSKCTL is utilized by SIO to keep track of the content of the 
SKCTL CD20F3 register# which is a write-only register. 


J. ATARI CONTROLLERS 

The ATARI controllers are read as part of the Stage 2 VBLANK 
process. The encoded data is partially decoded and processed as 
shown in the subsections that follow. 


Joysticks 

Up to four joystick controllers can be attached to the computer 
console# each with a 9-position joystick plus a trigger button. 
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J1 STICKO - STICK3 C027S# 43 — Joystick position sense 


The 4 joystick position sense variables contain a bit-encoded 
position sense as shown below: 


76543210 

4 , *“+-— 4 -- 4 , ~ 4 — 4 , — 4 — 4 , — 4 * 

JO 0 0 05R tLJDSUt 

+_+_ 4 . — — h _ + _ 4 . 

where: R = 0 indicates joystick RIGHT sensor true. 

L * 0 indicates joystick LEFT sensor true. 

D * 0 indicates joystick DOWN sensor true. 

U « O indicates joystick UP sensor true. 

Nine unique combinations are possible# indicating the possible 
joystick positions shown below: 


CENTER $0F 
UP $0E 
UP /RIGHT $06 
RIGHT $07 
DOWN/RIGHT $05 
DOWN $0D 
DOWN/LEFT $09 
LEFT $0B 
UP /LEFT $0A 


J2 STRIGO - STRIG3 C0284# 43 — Joystick trigger sense 

The four joystick trigger sense variables each contain a single bit 
indicating the position of the joystick trigger as shown below: 


7 6 5 4 3 2 1 0 

+_+_+_ + „ 4 ._ 4 ._. + . — >.-+ 

JO 0 0 0 0 O OJTJ 

where: T = O indicates trigger pressed. 


Padd les 

Up to eight paddle controllers can be connected to the computer# 
each with a potentiometer and a trigger sense. 


J3 PADDLO - PADDL7 C 0270# 83 — Paddle position sense 

There is a single-byte variable associated with each paddle 
position sense# the values range from 228 for full 
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counterclockwise rotation to 1 for full clockwise rotation. 

The paddle values are often converted by the user* as shown 
below* to give a result of 0 for full counterclockwise rotation 
and 227 for full clockwise rotation: 

VALUE : - 228 - PADDLX* 

J4 PTRIGO - PTRIG7 C027C, 83 — Paddle trigger sense 

The 8-paddle trigger sense variables each contain a single bit 
indicating the position of the paddle trigger as shown below: 

76543210 

+-+-+-+--+-+--+-+-+ 

10 0 0 0 0 0 0 ! T ! 

4. — — h— + — 

where: T = 0 indicates trigger pressed. 


Light Pen 

The OS reads the position of a single light pen and stores the 
horizontal and vertical position codes in two variables; these codes 
are not the same as the actual screen coordinates. The pen position 
codes for different portions of the screen are shown below: 

Left edge — 67. 

Codes increase in increments of one to a value of 227# then go to O 
and continue to increase monotonical ly (one count per color clock). 
Right edge — 7. 

Upper edge — 16. 

Codes increase in increments of one (one count per two raster 
lines). Lower edge — ill. 

The light pen hardware will read and latch the pen position 60 times 
per second# independent of the pen button position# which is 
separately sensed. 

In order for the light pen to operate it must be positioned over a 
portion of the screen which has sufficient luminance to activate the 
photosensor in the pen# a blank (dark) screen will generally not 
provide enough luminance to utilize the light pen. 

J5 LPENH C0234#13 — Light pen horizontal position code 

LPENH contains the horizontal position code for the light pen* the 
algorithm below (written in Pascal) shows the conversion from position 
code to screen coordinate (screen mode 7): 

•C check for rollover point > 

•C adjust values to right of rollover > 


IF LPENH < 33 
THEN 
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XPOS := L PENH + 227 

ELSE •€ no adjustment to left of rollover point > 

XPOS := LPENH; 

XPOS : = XPOS - 67; < adjust for left edge offset > 

IF XPOS < O THEN XPOS : - O; 

IF XPOS > 159 THEN XPOS := 159; 

J6 LPENV £0235* 13 — Light pen vertical position code 


LPENV contains the vertical position code for the light pen; the 
algorithm below (written in Pascal) shows the conversion from position 
code to screen coordinate (screen mode 7): 

YPOS : * LPENV - 16; -C adjust for upper edge offset > 

IF YPOS < O THEN YPOS 0; 

IF YPOS > 95 THEN YPOS := 95* 

J7 STICKO - STICK3 C0278, 43 — Light pen button sense 

The light pen button sense is encoded in one of STICKO - STICK3 
(depending upon the actual controller port used) as shown 
below: 


7 0 

4 - — ►-+-+-+ 

.* «0*0«0!T* 

+“+“+— f —+“+“•+“+“+ 

where: T « O indicates the light pen button is pressed. 


Driving Controllers 

The driving controller has no position stops and thus allows unlimited 
rotation in either direction; the output of the controller is a 2-bit 
Gray code which can be used to determine the direction of rotation. 

The controller is sensed using the same internal hardware as the 
joystick* thus the same data base variables are used for both. 
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J8 STICKO - STICK3 £0278,43 — Driving controller sense 

The 4 driving controller sense variables contain an encoded 
rotation (position) sense value# as shown below: 

7 6 5 4 3 2 1 0 

+ — +**+“+—+“+~ 4 —+— + 

50 0 0 0 1 1 ! va 1 « 

+“ 4 — +- 4 — 4 —+“+- 4 —+ 


where a clockwise rotation of the controller produces the following 
continuous sequence of four values (shown in hexadec imal ) : 


OF, OD, OC, OE, OF, OD, 

and a counterclockwise rotation of the controller produces the 
following continuous sequence of four values: 


OF, OE, 0C,0D, OF, OE, 


J9 STRIGO - STRIG3 £0284, 43 — Driving trigger sense 

The four driving trigger sense variables each contain a single bit 
indicating the position of the driving trigger as shown below: 

76543210 
+— •+• — >-— ■« — *--+—+ — »._ + 

10 0 0 0 0 0 0 ! T ' 

where: T « 0 indicates trigger pressed. 


K. DISK FILE MANAGER 

See Section 5 for information relating to the Disk File Manager. 


K1 FMSZPG* C0043, 73 — FMS reserved space 

FMSZPG is the reserved space in the database for the variables shown 
below; the names associated with K2 through K5 are not in the system 
equate file. 


K2 ZBUFP* C0043, 23 -- Buffer pointer 
K3 ZDRVA* £0045,23 — Drive pointer 
K4 ZSBA* £0047,23 — Sector buffer pointer 
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K5 ERRNO* C 0049/ 13 


Error number 


L. DISK UTILITY POINTER 

LI DSKUTL* COOIA/ 23 — Page-zero pointer variable 

M. FLOATING POINT PACKAGE 

See Section 8 for a description of the Floating Point Packag 

Ml FRO COOD4/63 — FP register 0 

M2 FRE* COODA/ 63 — FP register (internal) 

M3 FRi COOEO# 63 — FP register 1 

M4 FR2* COOE 61 63 — FP register 2 (internal) 

M5 FRX* COOEC/13 — Spare (unused) 

M 6 EEXP* COOED/ 13 — Exponent value (internal) 

M7 NSIGN* COOEE/13 — Sign of mantissa (internal) 

M 8 ESIGN* COOEF/ 13 — Sign of exponent (internal) 

M9 FCHRFLG* COOFO/13 — First character flag (internal) 

MIO DIGRT* C OOF 1/13 — Digits to right of decimal point 

Mil CIX COOF2/13 — Character index 

M12 INBUFF COOF3/23 — Input text buffer pointer 
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M13 ZTEMP1* C00F5* 23 — Temporary storage 

M14 ZTEMP4* C00F7* 23 — Temporary storage 

M15 ZTEMP3* C00F9* 23 — Temporary storage 
M16 FLPTR COOFC*23 — Pointer to FP number 

M17 FPTR2* COOFE* 23 — FP package use 

M18 LBPRi* C057E* 1 3 — LBUFF preamble 

M19 LBPR2* C057F* 1 3 — LBUFF preamble 

M20 LBUFF C 0580, 963 — Text buffer 

M21 PLYARG* C05E0, 63 — FP register (internal) 

M22 FPSCR/FSCR* C05E6* 63 — FP register (internal) 

M23 FPSCR1/SCR1* C05EC* 63 — FP register (internal) 

M24 DEGFLG/RADFLG COOFB* 13 — Degrees/rad ians flag 

DEGFLG * 0 indicates radians* 6 indicates degrees. 


N. Power-Up and SYSTEM RESET 

See Section 7 for details of the power-up and system reset 
operations. 


RAM Sizing 

During power-up and system reset the first non-RAM address above 1000 
hex is located and its address retained using a nondestructive 
test. The first byte of every 4K memory "block" is tested to see if 
it is alterable* if so* the original value is restored and the next 
block is tested* and if not* that address is considered to be the 
end of RAM. 
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N1 RAMLO*/TRAMSZ* C 0004# 33 — RAM data/test pointer (temporary) 


RAMLQ+1 contains the LSB of the address to be tested (always 88 0) 
and TRAMSZ (same as RAMLO+2) contains the MSB of the address to be 
tested. RAMLO+O contains the complemented value of the data 
originally contained in the memory location being tested. 

Later in the ini tial i zation process these variables are used for 
totally unrelated functions; but first the value in TRAMSZ is moved 
to the variables RAMSIZ and MEMTOP+1. 


N2 TSTDAT* C0007, 13 — Test data byte save 

TSTDAT contains the original value of the memory location being 
tested. 


Diskette/Cassette-Boot 

As a part of the Power-up sequence# software can be booted from an 
attached disk drive or cassette player as explained in Section 10. 


N3 DOSINI COOOC#23 — Diskette-boot initialization vector. 

DOSINI contains the disk booted software initial i zation address 
from the beginning of the boot file (see Section 10) whenever a 
diskette-boot is successfully completed. 


N4 CKEY* C004A/13 — Cassette-boot request flag 

CKEY is an internal flag used to indicate that the console CSTART3 
key was pressed during Power-up# thus indicating that a 
cassette-boot is desired. CKEY equals zero when no cassette-boot is 
requested# and is nonzero when a cassette-boot is requested. The 
flag is cleared to zero after a cassette-boot. 


N5 CASSBT* C004B# 1 3 — Cassette-booting flag 

CASSBT is used during the cassette-boot process to indicate to 
shared code that the cassette is being booted and not the diskette. 
CASSBT equal to zero indicates a diskette-boot# and nonzero indicate 
a cassette-boot. 


N6 CASINI C 0002# 23 — Cassette-boot ini tial i zat ion vector 

CASINI contains the cassette-booted software ini t ial i zat ion address 
from the beginning of the boot file (see Section 10) whenever a 


250 


OPERATING SYSTEM C016555 — Appendix L 



cassette-boot is successfully completed. 


N7 BOOT?* C0009# 13 — Successful d iskette/cassette-boot flag. 

BOOT? indicates to the ini tial i zation processor which# if any# of 
the boot operations went to successful completion. The flag values 
are set by the OS and the format for the variable is shown below: 


7 6 5 4 3 2 1 0 
+-+-+-+-+— +-+ — ►_+ 


i IC'D? 

+-+-+-+-+-+-+- 4 — 4 - 


where: C * 1 indicates that the cassette-boot was completed. 

D = 1 indicates that the diskette-boot was completed. 


N8 DFLAGS* C0240#13 — Diskette flags 

DFLAGS contains the value of the first byte of the boot file# after a 
diskette-boot. See Section 10. 


N9 DBSECT* C0241# 13 — Diskette-boot sector count 

DBSECT is initially set to the value of the second byte of the boot 
file# during a diskette-boot# and is then used to control the number 
of additional diskette sectors read# if any. 


N10 BOOTAD* C 0242# 23 — Diskette-boot memory address 

BOOTAD is initially set to the value of the third and fourth 
bytes of the boot file# during a diskette-boot# and is not 
modified thereafter. 


Environment Control 

If# at the end of a power-up or system reset# control is not 
given to one of the cartridges (as explained in Sections 7 and 10)# 
then program control passes to the address contained in the data 
base variable DOSVEC. 


Nil COLDST* C0244# 13 — Coldstart complete flag 

COLDST is used by the initialization routine to detect the case of 
a system reset occurring before the completion of the power— up 
process. COLDST is set to $FF at the beginning of the power-up 
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sequence and is set to O at the completion; if a system reset 
occurs uihile the value is nonzero# the power— up sequence will be 
reinitiated (rather than initiating a system reset sequence). 


N12 DOSVEC COOOA#23 — Noncartridge control vector 

At the beginning of power-up the OS sets DOSVEC to point to the 
"b lac kboard" routine; DOSVEC can then be altered as a consequence 
of a diskette-boot or cassette-boot (as explained in Section 10) to 
establish a new control program. Control will be passed through 
DOSVEC on all power-up and system reset conditions in which a 
cartridge does not take control first. 


System Reset 


N13 WARMST C0008#13 — Warmstart flag 

WARMST equals ♦FF during a system reset (warmstart) 

ini tial i zation and equals 0 during a power-up ini tial i zation 

(coldstart ) . 


P. INTERRUPTS 

See Section 6 for a discussion of interrupt processing. 


PI CRITIC C0042# 13 — Critical code section flag 

CRITIC is used to signal to the VBLANK interrupt processor that a 
critical code section is executing without IRQ interrupts being 
inhibited; the VBLANK interrupt processor will' stop interrupt 
processing after stage 1 and before stage 2# just as if the 6502 
processor I bit were set# when CRITIC is set. 

CRITIC equal to zero indicates that the currently executing code 
section is noncritical# while any nonzero value indicates that the 
currently executing code section is critical. 


P2 POKMSK C0010#13 — POKEY interrupt mask 

POKMSK is a software maintained interrupt mask that is used in 
conjunction with the enabling and disabling of the various POKEY 
interrupts. This mask is required because the POKEY interrupt 
enable register IRQEN CD20E3 is a write-only register# and at any 
point in time the system can have several users independent ly 
enabling and disabling POKEY interrupts. POKMSK is updated by the 
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users to always contain the current content of IRQEN. 


System Timers 

The System Timers are discussed in detail in Section 6. 


Realtime Clock 

The realtime clock (or frame counter/ as it is sometimes called! 
is incremented as part of the stage 1 VBLANK process as explained 
in Section 6. 


P3 RTCLQK £0012/33 — Realtime frame counter 

RTCL0K+O is the most significant byte/ RTCL0K+1 the next most 
significant byte/ and RTCLOK+2 the least significant byte. See the 
discussions at D3 and preceding BIO for OS use of RTCL0K. 


System Timer 1 

System Timer 1 is maintained as part of the stage 1 VBLANK process/ 
and thus has the highest priority of any of the user timers. 


P 4 CDTMV1 £0218/23 — System Timer 1 value 

CDTMV1 contains zero when the timer is inactive/ otherwise it 
contains the number of VBLANKs remaining until timeout. Also see 
H26. 


P5 CDTMA1 £0226/23 — System Timer 1 jump address 

CDTMAi contains the address to which to JSR should the timer 
timeout. See also H27 and Section 6. 
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System Timer 2 


System Timer 2 is maintained as part of the stage 2 VBLANK process/ 
and has the second highest priority of the user timers. The OS does 
not have any direct use for System Timer 2. 


P 6 CDTMV2 £021A*23 — System Timer 2 value 

CDTMV2 contains zero when the timer is inactive* otherwise it 
contains the number of VBLANKs remaining until timeout. 


P7 CDTMA2 £0228/23 — System Timer 2 jump address 

CDTMA2 contains the address to which to JSR should the timer 
timeout. See Section 6 . 


System Timers 3* 4 and 5 

System Timers 3/ 4 and 5 are maintained as part of the stage 2 
VBLANK process* and have the lowest priority of the user timers. 
The OS does not have any direct use for these timers. 


P8 CDTMV3 C021C/23* CDTMV4 C021E/23 and CDTMV5 £0220*23 

These variables contain zero when the corresponding timers are 
inactive* otherwise they contain the number of VBLANKs remaining 
until timeout. 


P9 CDTMF3 £022 A* 1 3 * CDTMF4 £0220*13 and CDTMF5 £022E, 23 

Each of these 1-byte variables will be set to zero should its 
corresponding timer timeout. The OS never modifies these bytes 
except to set them to zero upon timeout (and initial ization). 


RAM Interrupt Vectors 

There are RAM vectors for many of the interrupt conditions within 
the system. See Section 6 for a discussion of the placing of values 
to these vectors. 
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NMI Interrupt Vectors 


P10 VDSLST 
This vector 

Pll WBLKI 
This vector 

P12 VVBLKD 

This vector 
See Section 


C 0200# 23 — Display-list interrupt vector 
is not used by the OS. See Section 6 . 

C0222, 23 — Immediate VBLANK vector 
is initialized to point to the OS stage 1 VBLANK 

£0224*23 — Deferred VBLANK vector 

is initialized to point to the OS VBLANK exit routine. 

6 . 


IRQ Interrupt Vectors 

P13 VIMIRG £0216* 23 — General IRQ vector 

This vector is initialized to point to the OS IRQ interrupt 
processor. See Section 6. 

P14 VPRCED £0202*23 — Serial I/O bus proceed signal 

The serial bus line that produces this interrupt is not used in the 
current system. See Section 6. 

P15 VINTER £0204* 23 — Serial I/O bus interrupt signal 

The serial bus line that produces this interrupt is not used in the 
current system. See Section 6. 


P16 VCBREAK3 £0206*23 — BRK instruction vector 

This vector is initialized to point to a PLA* RTI sequence as the 
OS proper does not utilize the BRK instruction. See Section 6. 


P17 VKEYBD £0208* 23 — Keyboard interrupt vector 

This vector is initialized to point to the Keyboard Handler's 
interrupt service routine. See Section 6 and the discussion 
preceding El. 
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P18 VSERIN C020A# 23 — Serial I/O bus receive data ready 

This vector is initialized to point to the SIO utility's interrupt 
service routine. See Section 6. 


P19 VSEROR C020C# 23 — Serial I/O bus transmit ready 

This vector is initialized to point to the SIO utility's interrupt 
service routine. See Section 6. 


P20 VSEROC C020E# 23 — Serial I/O bus transmit complete 

This vector is initialized to point to the SIO utility's interrupt 
service routine. See Section 6. 


P21 VT I MR 1 C0210# 23* VTIMR2 C0212# 23 and VTIMR4 C0214#23 — POKEY 
timer vectors 

The POKEY timer interrupts are not used by the OS See Section 6. 


Hardware Register Updates 

As part of the stage 2 VBLANK process# certain hardware registers 
are updated from OS data base variables as explained in Section 6. 


P 22 SDMCTL* C022F, 13 — DMA control 

SDMCTL is set to a value of $02 at the beginning of a Display 
Handler OPEN command# and then later set to a value of $22. The 
value of SDMCTL is stored to DMACTL CD4003 as part of the stage 2 
VBLANK process. 


P23 SDLSTL* C0230#13 and SDLSTH* C 0231# 13 — Display list address 

The Display Handler formats a new display list with every OPEN 
command and puts the display list address in SDLSTL and SDLSTH. Th 
value of these bytes are stored to DLISTL CD4023 and DLISTH CD4033 
as part of the stage 2 VBLANK process. 


0360-036F 

0370-037F 

0380—038F 

0390-039F 

03A0-03AF 

03B0-03BF 


IOCB #2 
IOCB #3 
IOCB #4 
IOCB #5 
IOCB #6 
IOCB #7 
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NOTE: There is a potential timing problem associated with the 
updating of the hardware registers from the data base variables. 
Since the stage 2 VBLANK process is performed with interrupts 
enabled* it is possible for an IRQ interrupt to occur before the 
updating of DLISTH and DLISTL. If the processing of that 
interrupt (plus other nested interrupts) exceeds the 
vertical-b lank delag (1 msec)* then the display list pointer 
register will not have been updated when display list processing 
commences for the new frame* and a screen glitch will result. 


P24 GPRIOR* C026F* U — Priority control 

The Display Handler alters bits 6 and 7 of GPRIOR as part of 
establishing the GTIA mode. The value of GPRIOR is stored to 
PRIOR CD01B3 as part of the stage 2 VBLANK process. 

P25 CHACT* C02F3* 1 3 — Character control 

The Display Handler sets CHACT to $02 on every OPEN command. The 
value of CHACT is stored to CHACTL CD4013 as part of the stage 2 
VBLANK process. 


P26 CHBAS C02F4* 13 — Character address base 

The Display Handler sets CHBAS to $EO on every OPEN command. The 
value of CHBAS is stored to CHBASE CD4093 as part of the stage 2 
VBLANK process. This variable controls the character subset for 
screen modes 1 and 2* a value of $E0 provides the capital letters 
and number set whereas a value of $E2 provides the lowercase 
letters and special graphics set. See B55 for more information. 


P27 PCOLRx C02C0* 43 and COLORx C02C4* 53 — Color registers 
See B7 and B8. 


Internal Working Variables 

P28 INTEMP* C022D* 1 3 — Temporary storage 
INTEMP is used by the SETVBL (SETVBV) routine. 
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R. USER AREAS 


The areas shown below are available to the user in a non-nested 
environment. See Section 4 for further information. 


R1 £0080* 1283 

R2 £0480*6403 
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ALPHABETICAL LIST OF DATA BASE VARIABLES 


NAME 


ADDCOR 
ADRESS 
APPMHI 
ATACHR 
ATRAC T 

BFENHI 

BFENLO 

BITMSK 

BLIM 

BOOT? 

BOOTAD 

BOTSCR 

BPTR 

BRKKEY 

BUFADR 

BUFCNT 

BUFRFL 

BUFRHI 

BUFRLO 

BUFSTR 

CASBUF 

CASFLG 

CASINI 

CASSBT 

CAUX1 

CAUX2 

CBAUDH 

CBAUDL 

CCOMND 

CDEVIC 

CDTMA1 

CDTMA2 

CDTMF3 

CDTMF4 

CDTMF5 

CDTMV1 

CDTMV2 

CDTMV3 


VID 

ADDRESS SI 

D4 

030Ei 1 

B39 

0064# 2 

A3 

OOOE# 2 

B54 

02FB, 1 

BIO 

004D# 1 

H17 

0035# 1 

H17 

0034, 1 

B50 

006E# 1 

DIO 

028 A# 1 

N7 

0009# 1 

NIO 

0242# 2 

B16 

02BF# 1 

Dll 

003D# 1 

E5 

0011# 1 

Cl 

0015# 2 

B42 

006B# 1 

H21 

0038# 1 

H16 

0033# 1 

H16 

0032# 1 

B43 

006C # 2 

D9 

03FD# 131 

D8 

030F# 1 

N6 

0002, 2 

N5 

004B# 1 

H20 

023C# 1 

H20 

023D# 1 

Di 

02EF# 1 

D1 

02EE# 1 

H19 

023B# 1 

H18 

023 A# 1 

P5» H27 

0226# 2 

P7 

0228# 2 

P9 

022 A# 1 

P9 

022C# 1 

P9 

022E# 1 

P4# H26 

0226# 2 

P6 

021 A# 2 

P8 

02 1C# 2 
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CDTMV4 

CDTMV5 

CH 

CHKSNT 

CHI 

CHACT 

CHAR 

CHBAS 

CHKSNT 

CHKSUM 

C IOC HR 

CIX 

CKEY 

COLAC 

COLCRS 

COLDST 

COL INC 

COLORO 

COLOR 1 

C0L0R2 

COLORO 

C0L0R4 

COLRSH 

COUNTR 

CRETRY 

CRITIC 

CRSINH 

CSTAT 

DAUX1 

DAUX2 

DBSECT 

DBUFHI 

DBUFLO 

DBYTHI 

DBYTLO 

DCB 

DCOMND 

DDEVIC 

DEGFLG 

DELTAC 

DELTAR 

DFLAGS 

DIGRT 

D INDEX 

DMASK 

DOSINI 

DOSVEC 

DRETRY 

DRKMSK 

DSKTIM 

DSKUTL 

DSPFLG 

DSTAT 
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P8 

P8 

£3 

H14 

El 

P25 

B55 

P26 

H14 

H13 

G25 

Mil 

N4 

B24 

B2 

Nil 

B21 

B8, P27 
B8i P27 
B8# P27 
B8# P27 
BS, P27 
Bll 
B23 
HI 1 
PI 
B1 
S2 

H9 

H9 

N9 

H6 

H6 

H8 

H8 

HI 

H4 

H2 

M24 

B22 

B22 

N8 

M10 

B35 

B28 

N3 

N12 

H12 

B12 

C2 

LI 

B27 

B34 


021E, 2 
0220 , 2 
02FC, 1 
003B# 1 
02F2, 1 
02F3, 1 
02FA, 1 
02F4, 1 
003B, 1 
0031, 1 
002F, 1 
00F2, 1 
004A, 1 
0072, 2 
0055, 2 
0244, 1 
007A, 1 
02C4, 1 
02C5, 1 
02C6, 1 
02C7, 1 
02C8, 1 
004F, 1 
007E, 2 
0036, 1 
0042, 1 
02F0, 1 
0288, 1 

030 A, 1 
030B, 2 
0241, 1 

0304, 1 

0305, 1 

0308, 1 

0309, 1 
0300, 12 
0302, 1 
0300, 1 
OOFB, 1 
0077, 2 
0076, 1 
0240, 1 
00F1 , 1 
0057, 1 
02 AO, 1 
OOOC, 2 
000 A, 2 
0037, 1 
004E, 1 
0246, 1 
001 A, 2 
02FE, 1 
004C, 1 
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DSTATS 

H5 

0303# 1 

DTIMLO 

H7 

0306# 1 

DUN I T 

H3 

0301# 1 

DUNUSE 

S3 

0307# 1 

DVSTAT 

Gil 

02EA# 4 

EEXP 

M6 

OOED# 1 

ENDPT 

B25 

0074# 2 

ERRFLG 

H30 

023F# 1 

( ERRNO 

K5> 

0049# 1 

ESCFLG 

B26 

02A2# 1 

ESIGN 

M8 

OOEF# 1 

FCHRFL 

M9 

OOFO# 1 

FEOF 

D12 

003F# 1 

FILDAT 

B17 

02FD, 1 

FILFLG 

B 18 

02B7# 1 

FLPTR 

M16 

OOFC# 2 

FMSZPG 

K1 

0043# 7 

FPSCR 

M22 

05E6# 6 

FPSCR1 

M23 

05EC# 6 

FPTR2 

M17 

OOFE# 2 

FRO 

Ml 

00D4, 6 

FR1 

M3 

OOEO# 6 

FR2 

M4 

00E6# 6 

FRE 

M2 

OODA# 6 

FREQ 

D15 

0040, 1 

FRMADR 

B41 

0068# 2 

FRX 

M5 

OOEC# 1 

FSCR 

M22 

05E6# 6 

FSCR1 

M23 

05EC# 6 

FTYPE 

D13 

003E# 1 

GPRIOR 

P24 

026F# 1 

HATABS 

G12 

031 A# 38 

HOLD1 

B30 

0051# 1 

H0LD2 

B31 

029F# 1 

H0LD3 

B32 

029D# 1 

H0LD4 

B20 

02BC# 1 

HQLDCH 

E7 

007C # 1 

ICAXi 

G9 

034 A# 1 

ICAX1Z 

G21 

002A# 1 

ICAX2 

G9 

034B, 1 

ICAX2Z 

G21 

002B# 1 

ICBAH 

G6 

0345# 1 

ICBAHZ 

G18 

0025# 1 

ICBAL 

G6 

0344# 1 

ICBALZ 

G18 

0024# 1 

ICBLH 

G8 

0349# 1 

ICBLHZ 

G20 

0029# 1 

ICBLL 

G8 

0348# 1 

ICBLLZ 

G20 

0028# 1 
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ICCOM 

G4 

0342, 1 

ICCOMT 

G23 

0017, 1 

ICCOMZ 

G16 

0022, 1 

ICDNO 

G3 

0341, 1 

ICDNOZ 

G15 

0021, 1 

ICHID 

G2 

0340, 1 

ICHIDZ 

G14 

0020, 1 

ICIDNO 

G24, G2 

2002E, 1 

ICPTH 

G7 

0347, 1 

ICPTHZ 

G19 

0027, 1 

ICPTL 

G7 

0346, 1 

ICPTLZ 

G19 

0026, 1 

ICSPR 

GIO 

034C, 4 

ICSPRZ 

G22 

002C, 4 

ICSTA 

G5 

0343, 1 

ICSTAZ 

G17 

0023, 1 

INBUFF 

M12 

00F3, 2 

INSDAT 

B45 

007D, 1 

INTEMP 

P28 

022D, 1 

INVFLG 

E9 

02B6, 1 

IOCB 

G1 

0340, 16 

IOCBAS 

G13 

0020, 16 

KEYDEL 

E2 

02F1 , 1 

LBFEND 

M20 

0580, 96 

LBPR1 

M18 

057E, 1 

LBPR2 

M19 

057F, 1 

LBUFF 

M20 

0580, 96 

LINBUF 

B51 

0247, 40 

LMARGN 

B5 

0052, 1 

LOGCQL 

B15 

0063, 1 

LOGMAP 

B14 

02B2, 4 

MEMLO 

A1 

02E7, 2 

MEMTOP 

A2 

02E5, 2 

MLTTMP 

B40 

0066, 2 

NEWCOL 

B19 

0061, 2 

NEURON 

B19 

0060, 1 

NOCKSM 

H15 

003C, 1 

NSIGN 

M7 

OOEE, 1 

OLDADR 

B38 

005E, 2 

OLDCHR 

B37 

005D, 1 

OLDCOL 

B3 

005B, 2 

OLDROW 

B3 

005A, 1 

OPNTMP 

B40 

0066, 2 

PADDLO 

J3 

0270, 1 

PADDL1 

J3 

0271, 1 

PADDL2 

J3 

0272, 1 

PADDL3 

J3 

0273, 1 

PADDL4 

J3 

0274, 1 
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PADDL5 

J3 

0275. 1 

PADDL6 

J3 

0276. 1 

PADDL7 

J3 

0277. 1 

PBPNT* 

F3 

001D, 1 

PBUFSZ 

F2 

001E. 1 

PCOLRO 

B7, P27 

02C0, 1 

PCQLR1 

B7, P27 

02C1, 1 

PC0LR2 

B7, P27 

02C2. 1 

PC0LR3 

B7, P27 

02C3. 1 

PLYARG 

M21 

05E0. 6 

PQKMSK 

P2 

0010. 1 

PRNBUF 

Fi 

03C0. 40 

P TEMP 

F4 

00 IF. 1 

PTIMOT 

F5 

001C. 1 

PTRIGO 

J4 

027C. 1 

PTRIG1 

J4 

027D. 1 

PTRIG2 

J4 

027E. 1 

PTRIG3 

J4 

027F. 1 

PTRIG4 

J4 

0280. 1 

PTRIG5 

J4 

0281. 1 

PTRIG6 

J4 

0282. 1 

PTRIG7 

J4 

0283. 1 

RADFLG 

M24 

OOFB. 1 

RAMLO 

N1 

0004. 3 

RAMSIZ 

A5 

02E4. 1 

RAMTOP 

A4 

006A. 1 

RECVDN 

H22 

0039. 1 

RMARGN 

B6 

0053. 1 

ROW AC 

B24 

0070. 2 

ROWCRS 

B2 

0054. 1 

ROW INC 

B21 

0079, 1 

RTCLOK 

P3 

0012, 3 

SAVADR 

B41 

0068, 2 

SAVIO 

D7 

0316, 1 

SAVMSC 

B36 

0058, 2 

SCRFLG 

B9 

02BB, 1 

SDLSTH 

P23 

0231, 1 

SDLSTL 

P23 

0230, 1 

SDMCTL 

P22 

022F, 1 

SHF AMT 

B29 

006F, 1 

SHFLOK 

E6 

02BE, 1 

SOUNDR 

HIO 

0041, 1 

SRTIMR 

E8 

022B, 1 

SSFLAG 

E4 

02FF, 1 

SSKCTL 

H32 

0232, 1 

STACKP 

H28 

0318, 1 

STATUS 

H31 

0030, 1 

STICKO 

Jl, J7, J8 

0278, 1 

STICK! 

Jl, J7, J8 

0279, 1 

STICK2 

Ji, J7, J8 

027A, 1 

STICK3 

Jl. J7. J8 

027B, 1 

STRIGO 

J2, J7, J9 

0284, 1 
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STRIG1 

J2, V7, J9 

0285, 1 

STRIG2 

J2, J7 1 J9 

0286, 1 

STRIG3 

J2, J7, J9 

0284, 4 

SUBTMP 

B4S 

029E, 1 

SWPFLG 

B44 

007B, 1 

TABMAP 

B13 

02 A3, 15 

TEMP 

H23 

023E, 1 

TEMPI 

D5 

0312, 2 

TEMP 3 

06 

0315, 1 

TIMER 1 

03 

030C , 2 

TIMER2 

03 

0310,2 

TIMFLG 

02, H25 

0317, 1 

TINDEX 

B49 

0293, 1 

TMPCHR 

B33 

0050, 1 

TMPCQL 

B46 

02B9, 2 

TMPLBT 

B47 

02A1, 1 

TMPROW 

B46 

02B8, 1 

TOADR 

B40 

0066, 2 

TRAMSZ 

N1 

0004, 3 

TSTAT 

H29 

0319, 1 

TSTDAT 

N2 

0007, 1 

TXTCOL 

B4 

0291, 2 

TXTMSC 

B52 

0294, 2 

TXTOLD 

B53 

0296, 6 

TXTROW 

B4 

0290, 1 

USAREA 

R1 

0080, 128 

VBREAK 

P16 

0206, 2 

VDSLST 

P10 

0200, 2 

VIMIRG 

P13 

0216, 2 

VINTER 

P15 

0204, 2 

VKEYBD 

P17 

0208, 2 

VPRCED 

P14 

0202, 2 

VSERIN 

P18 

020 A, 2 

VSEROC 

P20 

020E, 2 

VSEROR 

P19 

020C, 2 

VTIMR1 

P21 

0210, 2 

VTIMR2 

P21 

0212, 2 

VTIMR4 

P21 

0214,2 

WBLKD 

P12 

0224, 2 

VVBLKI 

Pll 

0222, 2 

WARMST 

N13 

0008, 1 

WMODE 

014 

0289, 1 

XMTDQN 

H24 

003A, 1 

( ZBUFF 

K2> 

0043, 2 

< ZDRVA 

K3> 

0045, 2 

ZIOCB 

G13 

0020, 16 

( ZSBA 

K4> 

0047, 2 

Z TEMPI 

M13 

OOFS, 2 
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ZTEMP3 

ZTEWP4 


M15 
M 1 4 


00F9, 2 
00F7, 2 
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MEMORY ADDRESS 

ORDERED LIST OF DATABASE VARIABLES 

ADDRESS 

VID 


NAME 

OOOO-OOOl 

S7 


LNZBS 

0002-0003 

N6 


CASINI 

0004-0006 

N1 


RAMLQi TRAMSZ 

0007 

N2 


TSTDAT 

0008 

N13 


WARMST 

0009 

N7 


BOOT? 

OOOA-OOOB 

N12 


DOSVEC 

OOOC-OOOD 

N3 


DOS INI 

OOOE-OOOF 

A3 


APPMHI 

0010 

P2 


POKMSK 

0011 

E5 


BRKKEY 

0012-0014 

P3 


RTCLQK 

0015-0016 

Cl 


BUFADR 

0017 

G23 


ICCOMT 

001 A— 00 IB 

LI 


DSKUTL 

001C 

F5 


PTIMOT 

001D 

F3 


PBPNT 

001E 

F2 


PBUFSZ 

001F 

F4 


PTEMP 

0020 

G13* 014 


ICHIDZ 

0021 

G15 


ICDNOZ 

0022 

G16 


ICCOMZ 

0023 

G17 


I COB AS 

0024-0025 

G18 


ICBALZ, ICBAHZ 

0026-0027 

G19 


ICPTLZ# ICPTHZ 

0028-0029 

G20 


IOBLLZ/ ICBLHZ 

002A-002B 

G21 


ICAX1Z, ICAX2Z 

002C-002F 

G22, G24, G25 

ICSPRZ 

0030 

H31 


STATUS 

0031 

H13 


CHKSUM 

0032-0033 

H16 


BUFRLO» BUFFRHI 

0034-0035 

H17 


BFENLO/ BFENHI 

0036 

HU 


CRETRY 

0037 

H12 


DRETRY 

0038 

H21 


BUFRFL 

0039 

H22 


RECVDN 

003A 

H24 


XMTDON 

003B 

H14 


CHKSNT 

0030 

H15 


NOCKSM 

003D 

Dll 


BPTR 

003E 

D13 


FTYPE 

003F 

D12 


FEOF 

0040 

D15 


FREQ 

0041 

H10 


SOUNDR 

0042 

PI 


CRITIC 

0043-0049 

K1,K2, K3, 

K4» 

K5 ZBUFF/ ZBUFPi ZDRVA, ZSBA 

004A 

N4 


CKEY 

004B 

N5 


CASSBT 

0040 

B34 


DSTAT 
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004D 

BIO 

ATRACT 

004E 

B12 

DRKMSK 

004F 

Bll 

COLRSH 

0050 

B33 

TMPCHR 

0051 

B30 

H0LD1 

0052 

B5 

LMARGN 

0053 

B6 

RMARGN 

0054-0056 

B2 

ROWCRSi COLCRS 

0057 

B35 

DINDEX 

0058-0059 

B36 

SAVMSC 

005A-005C 

B3 

OLDRQW/ OLDCOL 

005D 

B37 

OLDCHR 

005E-005F 

B38 

OLDADR 

0060-0062 

B19 

NEWRQW* NEWCOL 

0063 

B15 

LOGCOL 

0064-0065 

B39 

ADRESS 

0066-0067 

B40 

MLTTMP, OPNTMP* TOADR 

0068-0069 

B41 

SAVADR /FRMADR 

006A 

A4 

RAMTOP 

006B 

B42 

BUFCNT 

006C-006D 

B43 

BUFSTR 

006E 

B50 

BITMSK 

006F 

B29 

SHF AMT 

0070-0073 

B24 

ROWAC, COLAC 

0074-0075 

B25 

ENDPT 

0076-0078 

B22 

DELTAR, DELTAC 

0079-007A 

B21 

ROWING* COLINC 

007B 

B44 

SWPFLG 

007C 

E7 

HOLDCH 

007D 

B45 

INSDAT 

007E-007F 

B23 

CQUNTR 

0080-00FF 

SEE FLOATING 

POINT VARIABLE LIST AT 

01 00-0 IFF 

6502 STACK 


0200-0201 

P10 

VDSLST 

0202-0203 

P14 

VPRCED 

0204-0205 

P15 

VINTER 

0206-0207 

P16 

VBREAK 

0208-0209 

P17 

VKEYBD 

020A-020B 

P18 

VSERIN 

020C-020D 

P19 

VSEROR 

020E-020F 

P20 

VSEROC 

0210-0215 

P21 

V I TMR 1 / VITMR2, VITMR4 

0216-0217 

P13 

VIMIRQ 

0218-0219 

P4i H26 

CDTMV1 

021A-021B 

P6 

CDTMV2 

02 1C— 0221 

P8 

CDTMV3i CDTMV4, CDTMV5 

0222-0223 

Pll 

VVBLKI 

0224-0225 

P12 

VVBLKD 

0226-0227 

P5i H27 

CDTMA1 

0228-0229 

P7 

CDTMA2 

022A 

P9 

CDTMF3 
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022B 

022C 

022D 

022E 

022F 

0230-0231 
0232 
023A 
023 B 

023C-023D 

023E 

023F 

0240 

0241 

0242-0243 

0244 

0246 

0247-026E 

026F 

0270-0277 

0278-027B 

027C-0283 

0284-0287 

0289 

028A 

028B-028F 

0290-0292 

0293 

0294-0295 

0296-029B 

029D 

029E 

029F 

02A0 

02 A 1 

02A2 

02A3-02B1 

02B2-02B5 

02B6 

02B7 

02B8-02BA 

02BB 

02BC 

02BE 

02BF 

02C0-02C3 

02C4-02C8 

02E4 

02E5-02E6 

02E7-02E8 

02EA-02ED 

02EE-02EF 

02F0 

02F1 


E8 

SR T I MR 

P9 

CDTMF4 

P28 

INTEMP 

P9 

CDTMF5 

P22 

SDMCTL 

P23 

SDLSTL, SDLSTH 

H32 

SSKCTL 

H18 

CDEVIC 

H19 

CCOMND 

H20 

CAUX1 , CAUX2 

H23 

TEMP 

H30 

ERRFLG 

N8 

DFLAGS 

N9 

DBSECT 

N10 

BOOTAD 

Nil 

COLDST 

C2 

DSKTIM 

B51 

LINBUF 

P 24 

GPRIOR 

J3 

PADDLO — PADDL7 

J 1, J7, JQ 

STICKO — STICKS 

J4 

PTRIGO — PTRIG7 

J2f J7, J9 

STRIGO — STRIG3 

D14 

WMODE 

DIO 

BLIM 

S10 

unused 

B4 

TXTROW, TXTCOL 

B49 

TINDEX 

B52 

TXTMSC 

B53 

TXTOLD 

B32 

H0LD3 

B48 

SUBTMP 

B31 

H0LD2 

B28 

DMASK 

B47 

TMPLBT 

B26 

ESCFLG 

B13 

TABMAP 

B14 

LOGMAP 

E9 

INVFLG 

B18 

FILFLG 

B46 

TMPROWi TMPCOL 

B9 

SCRFLG 

B20 

H0LD4 

E6 

SHFLOK 

B16 

BOTSCR 

B7/ P27 

PCOLRO — PC0LR3 

B8, P27 

PCOLRO — PC0LR4 

A5 

RAMS I Z 

A2 

MEMTOP 

A1 

MEMLO 

611 

DVSTAT 

D1 

CHBAUDL, CHBAUDH 

B1 

CRSINH 

E2 

KEYDEL 
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02F2 

El 

CHI 

02F3 

P25 

CHACT 

02F4 

P26 

CHBAS 

02FA 

B55 

CHAR 

02FB 

B54 

ATACHR 

02FC 

E3 

CH 

02FD 

B17 

FILDAT 

02FE 

B27 

DSPFLG 

02FF 

E4 

SSFLAG 

0300 

Hl» H2 

DCB/DDEVIC 

0301 

H3 

DUN IT 

0302 

H4 

DCOMND 

0303 

H5 

DSTATS 

0304-0305 

H6 

DBUFLO/ DBUFHI 

0306 

H7 

DTIMLO 

0308-0309 

H8 

DBYTLO, DBYTHI 

030A-030B 

H9 

DAUX1 » DAUX2 

030C-030D 

D3 

TIMER1 

030E 

D4 

ADDCOR 

030F 

D8 

CASFLG 

0310-0311 

D3 

TIMER2 

0312-0313 

D5 

TEMPI 

0315 

D6 

TEMP3 

0316 

D7 

SAVIO 

0317 

D2» H25 

TIMFLG 

0318 

H28 

STACKP 

0319 

H29 

TSTAT 

031A-033F 

G12 

HATABS 

0340 

0 1 / G2 

IOCBi ICHID 

0341 

G3 

ICDNO 

0342 

G4 

ICCOM 

0343 

G5 

ICSTA 

0344-0345 

G6 

ICBAL# ICBAH 


0346-0347 

G7 

ICPTL, ICPTH 

0348-0349 

G8 

ICBLLi ICBLH 

034A-034B 

09 

ICAX1 / ICAX2 

034C-034F 

G10 

ICSPR 

0350— 03 5F 

G2-G10 

< IQCB #1> 

0360-036F 

G2-G10 

< IOCB #2) 

0370-037F 

G2-G10 

( IOCB #3) 

0380-038F 

G2-G10 

(IOCB #4) 

0390— 039F 

G2-G10 

(IOCB #5> 

03A0-03AF 

G2-G10 

(IOCB #6) 

03B0-03BF 

G2-G10 

(IOCB #7) 

03C0-03E7 

FI 

PRNBUF 

03FD-047F 

D9 

CASBUF 

0480-06FF 

R2 

User Area 
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FLOATING POINT PACKAGE VARIABLES 


00D4-00D9 

Ml 

FRO 

OODA—OODF 

M2 

FRE 

00E0—00E5 

M3 

FR1 

00E6-00EB 

M4 

FR2 

OOEC 

M5 

FRX 

OOED 

M6 

EEXP 

OOEE 

M7 

NSIGN 

OOEF 

M8 

ESIGN 

OOFO 

M9 

FCHRFLG 

00F1 

M10 

DIGRT 

00F2 

Mil 

CIX 

00F3-00F4 

M12 

INBUFF 

00F5-00F6 

M13 

Z TEMPI 

00F7-00F8 

M14 

ZTEMP4 

00F9—00FA 

M15 

ZTEMP3 

OOFB 

M24 

RADFLG/DEGFLG 

OOFC-OOFD 

M16 

FLPTR 

OOFE-OOFF 

M17 

FPTR2 

057E 

M18 

LBPR1 

057F 

M19 

LBPR2 

0580— 05FF 

M20 

LBFEND, LBUFF 

05E0—05E5 

M21 

PLYARG 

05E6-05EB 

M22 

FPSCR/FSCR 

05EC-05F1 

M23 

FPSCR1/SCR1 
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INDEX 


The subject index contains three forms of references: 

Section number* such as '3. ' 

Appendix* such as 'App B' 

Variable ID from Appendix L* such as 'B7'. 


ATARI standards 
ATASC I I 
attract mode 

bit mapped graphics 

blackboard mode 

BNF 

boot 

BREAK 


12 

B54-55, 5, App D-G 
BIO- 12* 6, 

B28-B29* 5* App H 
3, N12* 7* 12 
1 

3* 4* N3-10, 5* 7* 10 
E5* 6* 12 


cartr idge 

cassette baud rate determine 
cassette-boot 
cassette device 
Cassette Handler <C) 

CIO (Central I/O Utility) 
ClO/user interface 
CIQ/Handler interface 
CLOSE I/O command 
coldstart (see 'Power-up') 
color control 
control characters 
critical section 
cursor 


3, 4, 7* 10 

D1-D7 

3, N3-10* 7* 10 

D1-D15* 3* 5 
5 

Gl-25* 5* 9 

Gl-ll* 5* App A* App B 

G 12-22* 9 

5* 9 

B7-8* 5* 6 
B26-27* 5. App D 
PI* 6 
Bl-4* 5 


database 

DCB (Device Control Block) 

DELETE I/O command 

development system 

device/filename specification 

Device Handler 

device table 

disk-boot 

disk device 

Disk File Manager (D) 

Disk Handler (resident) 
display device (screen) 
Display Handler (S) 
display list 
DOS (Disk Utilities) 

DRAM I/O command 
driving controller 
Educational System Format 
error handling 


4 

Hl-9* 

5 


5* 9 


13 
5 
5 * 

2 * 

3* 

5 

Kl-5* 5 
C 1-2, 5 
B54-55* 
B 1-55, 

4* P10 
LI* 12 
B 17-25, 
J8-9 

Cassettes 
G5, H5, 


9 

G12* 5* 7* 9 
N3-10, 5* 7* 


10 


5* App E* App H 


HI 1-12* 9* App B-C 
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EOF ( end-of-f i le > 

5 

File Management System 

5 

FILL I/O command 

B 17-25# 5 

floating point package 

2# 4# Mi-24, 8# 

FORMAT I/O command 

5 

free memory 

4# Al-3# Rl-2# 

game controllers 

3# Jl-9# 6# 11 

GET CHARACTER I/O command 

5# 9 

GET RECORD I/O command 

5# 9 

GET STATUS I/O command 

Gil# 5# 9 

Handler (see 'device handler' 

and individual 

init ial i zation# cartridge 

7 

initial ization# Handler 

7# 9 

initial ization# interrupt 

6 

init ial i zation# system 

4, 7# 10 

internal display code 

5, B54 

interrupts 

2# Pl-28# 6 

interrupt mask 

P2# 6 

inverse video (display) 

E9, 5 

I/O 

2# 4# 5, 9 

IOCB (I/O Control Block) 

G1-1G# 5# 9 

I/O retry logic 

HI 1-12 

joystick 

Jl-2 

keyboard Autorepeat 

E8 

keyboard device 

5 

Keyboard Handler (K) 

El-9# 5# App F 

keyboard key debouncing 

El-3 

light pen 

11# App J 

LNBUG 

13 

LOCK I/O command 

5 

logical text lines (screen) 

B 14-15# 5 

memory (see 'RAM'# 'ROM' and 

'free memory') 

memory dynamics 

Al-5# Nl-2# 4# 

memory map 

4 

NOTE I/O command 

5 

OPEN I/O command 

5# 9 

paddle 

J3-4 

page 0 

4# Mi-17# Rl# < 

page 1 

4# 9 

peripheral devices 

3 

POINT I/O command 

5 

Power-up 

2, Nl— 13# 4# 7 

printer device 

5# App G 


12 
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5 


Printer Handler (P) 
program development 
PUT CHARACTER I/O command 
PUT RECORD I/O command 

RAM 

record (I/O) 

RENAME I/O command 

RESET 

ROM (OS) 

RS-232-C Handler (R) 

Screen Editor (E) 

screen margins 

screen modes 

scrolling (text) 

serial I/O bus 

C SHI FT 3 /CONTROL lock 

SIO (Serial bus I/O Utility) 

sound control (SIO) 

SPECIAL I/O commands 
split screen 
stac k 

start/stop (display) 
stage 1 VBLANK process 
stage 2 VBLANK process 

tabs (Screen Editor) 
timeout (device) 
timers (system) 

UNLOCK I/O command 
user workspace 

vectorsi RAM 
vectors# ROM 
vertical blank interrupt 

warmstart (see 'RESET') 
wild-card (disk filename) 

ZIOCB (Zero-page IOCB) 


Fl-5# 

13 

5# 9 
5# 9 

3, 4# 9 

5 

5 

2, Nl-13# 6# 7# 12 

1# 4 
5# 9 

Bl-55# 5 
B5-6# 5, 7 
4# 5/ App H 

B9, 5 

3# 5# 9 # App I 
E6-7; 5 

Hl-32, PI 3-21# 5# 9# App C 
HIO# 11 
5, 9 
B16# 5 

4 

E4# 5, 12 

P3-5# 6 

P6-9, P22-27, 6 

B13# 5 
H25-27# 9 
P3-9, 6 

5 

4# M18-23# R2 

P5# P7# PI 0-21 # 6# 9 
5# 9# App J 
PI 1-12# 6 


5 

013-22# 9# 0020# 16 
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ATARI* HOME COMPUTER SYSTEM 


OPERATING SYSTEM 
SOURCE LISTING 
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© 
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ERR LINE ADDR B1 B2 B3 B4 


6500 ASSEMBLER VER 1 . OMR 


PAGE 


1 


1 LIST X 

THIS IS THE MODIFIED SEPTEMBER ATARI 400/800 COMPUTER OPERATING 
SYSTEM LISTING, MODIFIED TO ASSEMBLE ON THE MICROTEC CROSS 
ASSEMBLER. 

THIS VERSION IS THE ONE WHICH WAS BURNED INTO ROM. 

THERE IS A RESIDUAL PIECE OF CODE WHICH IS FOR LNBUG. THIS 
IS AT LOCATION *7000 WHICH IS NOT IN ROM. 

THIS IS THE REVISION B EPROM VERSION 
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6500 ASSEMBLER VER 1 . OMR 


34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 E400 

56 E410 

57 E420 

58 E430 

59 E440 


COLLEEN OPERATING SYSTEM EQUATE FILE 


NTSC /PAL ASSEMBLY FLAG 


17 

18 

19 

20 
21 

0000 

PALFLG 

t 

i 

i 

i 

MODULE 

0 

ORIGIN TABLE 

0 = NTSC 1 = PAL 

22 

EOOO 

CHRORG 

SS 

SEOOO 

CHARACTER SET 

23 

E400 

VECTBL 

ss 

*E400 

VECTOR TABLE 

24 

E480 

VCTABL 

SB 

*E4SQ 

RAM VECTOR INITIAL VALUE 

25 

E4A6 

CIOORG 

SB 

$E4A6 

CENTRAL I/O HANDLER 

26 

E6D5 

INTORG 

ss 

*E6D5 

INTERRUPT HANDLER 

27 

E944 

SIOORG 

= 

$E944 

SERIAL I/O DRIVER 

28 

EDEA 

DSKORG 

= 

$EDEA 

DISK HANDLER 

29 

EE78 

PRNORG 

ss 

$EE78 

PRINTER HANDLER 

30 

EF41 

CASORG 

ss 

*EF41 

CASSETTE HANDLER 

31 

F0E3 

MONORG 

ss 

$F0E3 

MON I TOR /POWER UP MODULE 

32 

33 

F3E4 

KB DOR G 

/ 

= 

$F3E4 

KEYBOARD/DISPLAY HANDLER 


VECTOR TABLE 

HANDLER ENTRY POINTS ARE CALLED OUT IN THE FOLLOWING VECTOR 
TABLE. THESE ARE THE ADDRESSES MINUS ONE. 


EXAMPLE FOR EDITOR 

E400 OPEN 

2 CLOSE 

4 GET 

6 PUT 

8 STATUS 

A SPECIAL 

C JUMP TO POWER ON INITIALIZATION ROUTINE 

. F NOT USED 


i 

EDITRV = 

*E400 

EDITOR 

SCRENV = 

$E410 

TELEVISION SCREEN 

KEYBDV = 

*E420 

KEYBOARD 

PR INTV ss 

*E430 

PRINTER 

CASETV = 

$E440 

CASSETTE 


JUMP VECTOR TABLE 


THE FOLLOWING IS A TABLE OF JUMP INSTRUCTIONS 
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3 


64 


65 


66 

E450 

67 

E453 

68 

E456 

69 

E459 

70 

E45C 

71 

E45F 

72 

E462 

73 

E465 

74 

E468 

75 

E46B 

76 

E46E 

77 

E471 

78 

E474 

79 

E477 

80 

E47A 

81 

E47D 

82 


83 


84 


85 


86 


87 


88 

0003 

89 

0005 

90 

0007 

91 

0009 

92 

OOOB 

93 

OOOC 

94 

OOOD 

95 

OOOE 

96 


97 


98 

0011 

99 

0012 

100 

0020 

101 

0021 

102 

0022 

103 

0023 

104 

0024 

105 

0025 

106 

0026 

107 

OOFF 

108 


109 


110 


111 

0001 

112 

0002 

113 

0004 

114 

0008 

115 

OOOC 

116 

0010 

117 

0020 


iTO VARIOUS ENTRY POINTS IN THE OPERATING SYSTEM. 


DISKIV = $E450 i DISK INITIALIZATION 

DSKINV = $E453 .DISK INTERFACE 

CIOV = $E456 ; CENTRAL INPUT OUTPUT ROUTINE 

SIOV = $E459 ; SERIAL INPUT OUTPUT ROUTINE 

SETVBV = $E45C ; SET SYSTEM TIMERS ROUTINE 

SYSVBV = $E45F ; SYSTEM VERTICAL BLANK CALCULATIONS 

XITVBV = $E462 ; EXIT VERTICAL BLANK CALCULATIONS 

SIOINV = $E465 .SERIAL INPUT OUTPUT INITIALIZATION 

SENDEV = $E468 ; SEND ENABLE ROUTINE 

INTINV = $E46B ; INTERRUPT HANDLER INITIALIZATION 

CIOINV = $E46E i CENTRAL INPUT OUTPUT INITIALIZATION 

BLKBDV = $E471 i BLACKBOARD MODE 

WARMSV * $E474 i WARM START ENTRY POINT 

COLDSV = $E477 .COLD START ENTRY POINT 

RBLOKV = $E47A ; CASSETTE READ BLOCK ENTRY POINT VECTOR 

CSOPIV = $E47D i CASSETTE OPEN FOR INPUT VECTOR 

i VCTABL = $E480 


i OPERATING SYSTEM EQUATES 
; COMMAND CODES FOR IOCB 

OPEN * 3 ; OPEN FOR INPUT/OUTPUT 

GETREC = 5 » GET RECORD (TEXT) 

GETCHR * 7 i GET CHARACTER (S) 

PUTREC * 9 i PUT RECORD (TEXT) 

PUTCHR = $B i PUT CHARACTER (S) 

CLOSE * $C ; CLOSE DEVICE 

STATIS « $D ; STATUS REQUEST 

SPECIL = $£ ; BEGINNING OF SPECIAL ENTRY COMMANDS 

i SPECIAL ENTRY COMMANDS 

DRAWLN = $11 ; DRAW LINE 

FILLIN = $12 i DRAW LINE WITH RIGHT FILL 

RENAME * $20 .RENAME DISK FILE 

DELETE = $21 i DELETE DISK FILE 

FORMAT = $22 ; FORMAT 

LOCKFL = $23 ; LOCK FILE TO READ ONLY 

UNLOCK * $24 i UNLOCK LOCKED FILE 

POINT = $25 .POINT SECTOR 

NOTE = $26 ; NOTE SECTOR 

IOCFRE = $FF ; IOCB "FREE" 

i 

i AUXl EQUATES 

j () INDICATES WHICH DEVICES USE BIT 

APPEND = $1 ; OPEN FOR WRITE APPEND (D), OR SCREEN READ ( 

DIRECT = $2 i OPEN FOR DIRECTORY ACCESS (D) 

OPNIN = $4 ; OPEN FOR INPUT (ALL DEVICES) 

OP NOT * $8 » OPEN FOR OUTPUT (ALL DEVICES) 

OPNINO = OPN I N+OPNOT ; OPEN FOR INPUT AND OUTPUT (ALL DEVICES) 

MXDMOD = $10 ; OPEN FOR MIXED MODE (E. S) 

INSCLR = $20 ; OPEN WITHOUT CLEARING SCREEN (E, S) 
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118 


119 


120 

0045 

121 

004B 

122 

0053 

123 

0050 

124 

0043 

125 

004D 

126 

0044 

127 


128 


129 

009B 

130 


131 


132 


133 


134 

0001 

135 


136 

0080 

137 

0081 

138 

0082 

139 

0083 

140 

0084 

141 

0085 

142 

0086 

143 

0087 

144 

0088 

145 

0089 

146 

008A 

147 

008B 

148 

008C 

149 

008D 

150 

008E 

151 

008F 

152 


153 

0090 

154 

0091 

155 

0092 

156 

0093 

157 


158 


159 


160 


161 


162 


163 


164 


165 


166 

0000 

167 


168 


169 

0002 

170 

0004 

171 

0006 


; DEVICE NAMES 


SCREDT = 'E 

KBD ■ 'K 

DISPLY = 'S 

PRINTR = 'P 

CASSET * 'C 

MODEM = 'M 

DISK = 'D 


SCREEN EDITOR (R/W) 

KEYBOARD <R ONLY) 

SCREEN DISPLAY (R/W) 

PRINTER (W ONLY) 

CASSETTE 

MODEM 

DISK (R/W) 


; SYSTEM EOL (CARRIAGE RETURN) 
CR = $9B 


OPERATING SYSTEM STATUS CODES 



; SUCCESSFUL OPERATION 

; BREAK KEY ABORT 
* IOCB ALREADY OPEN 
; NON-EXISTANT DEVICE 
; IOCB OPENED FOR WRITE ONLY 
i INVALID COMMAND 
/ DEVICE OR FILE NOT OPEN 
; INVALID IOCB NUMBER 
; IOCB OPENED FOR READ ONLY 
i END OF FILE 
; TRUNCATED RECORD 
; PERIPHERAL DEVICE TIME OUT 
; DEVICE DOES NOT ACKNOWLEDGE COMMAND 
; SERIAL BUS FRAMING ERROR 
; CURSOR OVERRANGE 
; SERIAL BUS DATA OVERRUN 
; SERIAL BUS CHECKSUM ERROR 

; PERIPHERAL DEVICE ERROR (OPERATION NOT COMP 
; BAD SCREEN MODE NUMBER 
» FUNCTION NOT IMPLEMENTED IN HANDLER 
i INSUFIC IENT MEMORY FOR SCREEN MODE 


i PAGE ZERO RAM ASSIGNMENTS 

i 

*=$0000 

LINZBS: .RES 2 ; L INBUG RAM (WILL BE REPLACED BY MONITOR RAM 

t 

i THESE LOCATIONS ARE NOT CLEARED 

CASINI : .RES 2 ; CASSETTE INIT LOCATION 

RAMLO: .RES 2 ; RAM POINTER FOR MEMORY TEST 

TRAMSZ: .RES 1 i TEMPORARY REGISTER FOR RAM SIZE 
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172 

0007 

TSTDAT 

. RES 

1 

RAM TEST DATA REGISTER 



173 


» 






174 


i CLEARED ON 

COLDSTART ONLY 




175 

0008 

WARMST 

. RES 

1 

WARM START FLAG 



176 

0009 

BOOT?: 

. RES 

1 

SUCCESSFUL BOOT FLAG 



177 

OOOA 

DOSVEC 

. RES 

2 

DISK SOFTWARE START VECTOR 



178 

OOOC 

DOS INI 

. RES 

2 

DISK SOFTWARE I NIT ADDRESS 



179 

OOOE 

APPMHI 

. RES 

2 

APPLICATIONS MEMORY HI LIMIT 



180 


/ 






181 


; CLEARED ON 

COLD OR WARM START 



182 

0010 

INTZBS 

=•* 


INTERRUPT HANDLER 



183 

0010 

POKMSK 

. RES 

1 

SYSTEM MASK FOR POKEY IRQ ENABLE 



184 

0011 

BRKKEY 

. RES 

1 

BREAK KEY FLAG 



185 

0012 

RTCLQK 

. RES 

3 

REAL TIME CLOCK (IN 16 MSEC UNITS) 



186 


i 






187 

0015 

BUFADR 

. RES 

2 

INDIRECT BUFFER ADDRESS REGISTER 



188 


f 






189 

0017 

ICCOMT 

. RES 

1 

COMMAND FOR VECTOR 



190 


; 






191 

0018 

DSKFMS 

. RES 

2 

DISK FILE MANAGER POINTER 



192 

001 A 

DSKUTL 

. RES 

2 

DISK UTILITIES POINTER 



193 


i 






194 

001C 

PTIMOT 

. RES 

1 

PRINTER TIME OUT REGISTER 



195 

00 ID 

PBPNT : 

. RES 

1 

PRINT BUFFER POINTER 



196 

00 IE 

PBUFSZ 

. RES 

1 

PRINT BUFFER SIZE 



197 

00 IF 

PTEMP : 

. RES 

1 

TEMPORARY REGISTER 



198 


i 






199 

0020 

ZIOCB 

=* 


ZERO PAGE I/O CONTROL BLOCK 



200 

0010 

IOCBSZ 

as 

16 

NUMBER OF BYTES PER IOCB 



201 

0080 

MAX IOC 

as 

8* IOCBSZ 

LENGTH OF THE IOCB AREA 



202 

0020 

IOCBAS 

as* 





203 

0020 

ICHIDZ 

. RES 

1 

HANDLER INDEX NUMBER (FF = IOCB FREE) 



204 

0021 

ICDNOZ 

. RES 

1 

DEVICE NUMBER (DRIVE NUMBER) 



205 

0022 

ICCOMZ 

. RES 

1 

COMMAND CODE 



206 

0023 

ICSTAZ 

. RES 

1 

STATUS OF LAST IOCB ACTION 



207 

0024 

ICBALZ 

. RES 

1 

BUFFER ADDRESS LOW BYTE 



208 

0025 

ICBAHZ 

. RES 

1 




209 

0026 

ICPTLZ 

. RES 

1 

PUT BYTE ROUTINE ADDRESS - 1 



210 

0027 

ICPTHZ 

. RES 

1 




211 

0028 

ICBLLZ 

. RES 

1 

BUFFER LENGTH LOW BYTE 



212 

0029 

ICBLHZ 

. RES 

1 




213 

002A 

ICAX1Z 

. RES 

1 

AUXILIARY INFORMATION FIRST BYTE 



214 

002B 

ICAX2Z 

. RES 

1 




215 

002C 

ICSPRZ 

, RES 

4 

TWO SPARE BYTES (CIO LOCAL USE) 



216 

002E 

ICIDNO 

= 

ICSPRZ+2 

IOCB NUMBER X 16 



217 

002F 

C IOC HR 

as 

ICSPRZ+3 

CHARACTER BYTE FOR CURRENT OPERATION 



218 


i 






219 

0030 

STATUS 

. RES 

1 

INTERNAL STATUS STORAGE 



220 

0031 

CHKSUM 

. RES 

1 

CHECKSUM (SINGLE BYTE SUM WITH CARRY) 



221 

0032 

BUFRLO 

. RES 

1 

POINTER TO DATA BUFFER (LO BYTE) 



222 

0033 

BUFRHI 

. RES 

1 

POINTER TO DATA BUFFER (HI BYTE) 



223 

0034 

BFENLO 

. RES 

1 

NEXT BYTE PAST END OF THE DATA BUFFER 

(LO 

B 

224 

0035 

BFENHI 

. RES 

1 

NEXT BYTE PAST END OF THE DATA BUFFER 

(HI 

B 

225 

0036 

CRETRY 

. RES 

1 

NUMBER OF COMMAND FRAME RETRIES 
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226 

0037 

DRETRY 

. RES 

227 

0038 

BUFRFL 

. RES 

228 

0039 

RECVDN 

. RES 

229 

003A 

XMTDON 

. RES 

230 

003B 

CHKSNT 

. . RES 

231 

003C 

NOCKSM 

. RES 

232 


i 


233 


# 


234 

003D 

BPTR: 

. RES 

235 

003E 

FTYPE: 

. RES 

236 

003F 

FEOF: 

. RES 

237 

0040 

FREQ: 

. RES 

238 

0041 

SOUNDR 

. RES 

239 

0042 

CRITIC 

. RES 

240 


; 


241 

0043 

FMSZPG 

. RES 

242 


t 


243 


i 


244 

004A 

CKEY : 

. RES 

245 

004B 

CASSBT 

. RES 

246 

004C 

DSTAT : 

. RES 

247 


/ 


248 

0040 

ATRACT 

. RES 

249 

004E 

DRKMSK 

. RES 

250 

004F 

COLRSH 

. RES 

251 


# 


252 

0002 

L EDGE 

= 

253 

0027 

REDGE 

= 

254 

0050 

TMPCHR 

. RES 

255 

0051 

HOLD 1 : 

. RES 

256 

0052 

LMARGN 

. RES 

257 

0053 

RMARGN 

. RES 

258 

0054 

ROWCRS 

. RES 

259 

0055 

COLCRS 

. RES 

260 

0057 

D INDEX 

. RES 

261 

0058 

SAVMSC 

. RES 

262 

00 5 A 

OLDROW 

. RES 

263 

005B 

OLDCOL 

. RES 

264 

00 5D 

OLDCHR 

. RES 

265 

00 5E 

OLDADR 

. RES 

266 

0060 

NEWROW 

. RES 

267 

0061 

NEWCOL 

. RES 

268 

0063 

LOGCOL 

. RES 

269 

0064 

ADRESS 

. RES 

270 

0066 

liLTTMP 

. RES 

271 

0066 

OPNTMP 

= 

272 

0068 

SAVADR 

. RES 

273 

006A 

RAMTOP 

. RES 

274 

006B 

BUFCNT 

. RES 

275 

006C 

BUFSTR 

. RES 

276 

006E 

B I TMSK 

. RES 

277 

006F 

SHFAMT 

. RES 

278 

0070 

ROWAC : 

. RES 

279 

0072 

COLAC: 

. RES 


rn ni 
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280 

0074 

281 

0076 

282 

0077 

283 

0079 

284 

007A 

285 

007B 

286 

007C 

287 

007D 

288 

007E 

289 


290 


291 


292 


293 


294 


295 


296 


297 


298 


299 


300 


301 


302 


303 


304 


305 


306 


307 


308 


309 


310 

0200 

311 

0200 

312 

0202 

313 

0204 

314 

0206 

315 

0208 

316 

020 A 

317 

020C 

318 

020E 

319 

0210 

320 

0212 

321 

0214 

322 

0216 

323 

0218 

324 

021 A 

325 

02 1C 

326 

02 IE 

327 

0220 

328 

0222 

329 

0224 

330 

0226 

331 

0228 

332 

022A 

333 

022B 


ENDPT: 

. RES 

2 




DELTAR 

. RES 

1 




DELTAC 

. RES 

2 




ROWING 

. RES 

1 




COLINC 

. RES 

1 




SWPFLG 

. RES 

1 

i NON-O 

IF TXT AND 

REGULAR RAM IS SWAPPED 

HOLDCH 

. RES 

1 

i CH IS 

MOVED HERE 

IN KGETCH BEFORE CNTL & SH 

INSDAT 

. RES 

1 




COUNTR 

. RES 

2 





80 - FF ARE RESERVED FOR USER APPLICATIONS 

NOTE : SEE FLOATING POINT SUBROUTINE AREA FOR ZERO PAGE CELLS 

PAGE 1 - STACK 


PAGE TWO RAM ASSIGNMENTS 


INTABS 

*=$0200 

=•* 


VDSLST 

. RES 

2 

VPRCED 

. RES 

2 

VINTER 

. RES 

2 

VBREAK 

. RES 

2 

VKEYBD 

. RES 

2 

VSERIN 

. RES 

2 

VSEROR 

. RES 

2 

VSEROC 

. RES 

2 

VTIMR1 

. RES 

2 

VTIMR2 

. RES 

2 

VTIMR4 

. RES 

2 

VIMIRQ 

. RES 

2 

CDTMV1 

. RES 

2 

CDTMV2 

. RES 

2 

CDTMV3 

. RES 

2 

CDTMV4 

. RES 

2 

CDTMV5 

. RES 

2 

VVBLKI 

. RES 

2 

VVBLKD 

. RES 

2 

CDTMA1 

. RES 

2 

CDTMA2 

. RES 

2 

CDTMF3 

. RES 

1 

SRTIMR 

. RES 

1 


INTERRUPT RAM 
DISPLAY LIST NMI VECTOR 
PROCEED LINE IRQ VECTOR 
INTERRUPT LINE IRQ VECTOR 

SOFTWARE BREAK (00) INSTRUCTION IRQ VECTOR 

POKEY KEYBOARD IRQ VECTOR 

POKEY SERIAL INPUT READY IRQ 

POKEY SERIAL OUTPUT READY IRQ 

POKEY SERIAL OUTPUT COMPLETE IRQ 

POKEY TIMER 1 IRQ 

POKEY TIMER 2 IRQ 

POKEY TIMER 4 IRQ 

IMMEDIATE IRQ VECTOR 

COUNT DOWN TIMER 1 

COUNT DOWN TIMER2 

COUNT DOWN TIMER 3 

COUNT DOWN TIMER 4 

COUNT DOWN TIMER 5 

IMMEDIATE VERTICAL BLANK NMI VECTOR 
DEFERRED VERTICAL BLANK NMI VECTOR 
COUNT DOWN TIMER 1 JSR ADDRESS 

COUNT DOWN TIMER 2 JSR ADDRESS 

COUNT DOWN TIMER 3 FLAG 

SOFTWARE REPEAT TIMER 
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334 

022C 

CDTMF4 

. RES 

1 

335 

022D 

INTEMP 

. RES 

1 

336 

022E 

CDTMF5 

. RES 

1 

337 

022F 

SDMCTL 

. RES 

1 

338 

0230 

SDLSTL 

. RES 

1 

339 

0231 

SDLSTH 

. RES 

1 

340 

0232 

SSKCTL 

. RES 

1 

341 

0233 


. RES 

1 

342 


/ 



343 

0234 

LPENH: 

. RES 

1 

344 

0235 

LPENV: 

. RES 

1 

345 

0236 

BRKKY: 

. RES 

2 

346 


i 



347 

0238 


. RES 

2 

348 


; 



349 

023A 

CDEVIC 

. RES 

1 

350 

023B 

CCOMND 

. RES 

1 

351 

023C 

CAUX1: 

. RES 

1 

352 

023D 

CAUX2: 

. RES 

1 

353 


s NOTE : MAY 

NOT 3E 

354 

023E 

TEMP: 

. RES 

1 

355 


; NOTE : MAY 

NOT BE 

356 

023F 

ERRFLG 

. RES 

1 

357 


i 



358 

0240 

DFLAGS 

. RES 

1 

359 

0241 

DBSECT 

. RES 

1 

360 

0242 

BOOTAD 

. RES 

2 

361 

0244 

COLDST 

. RES 

1 

362 


i 



363 

0245 


. RES 

1 

364 


) 



365 

0246 

DSKTIM 

. RES 

1 

366 


t 



367 

0247 

LINBUF 

. RES 

40 

368 


; 



369 

026F 

GPRIOR 

. RES 

1 

370 


# 



371 

0270 

PADDLO 

. RES 

1 

372 

0271 

PADDL1 

. RES 

1 

373 

0272 

PADDL2 

. RES 

1 

374 

0273 

PADDL3 

. RES 

1 

375 

0274 

PADDL4 

. RES 

1 

376 

0275 

PADDL5 

. RES 

1 

377 

0276 

PADDL6 

. RES 

1 

378 

0277 

PADDL7 

. RES 

1 

379 

0278 

STICKO 

. RES 

1 

380 

0279 

STICK1 

. RES 

1 

381 

027A 

STICK2 

. RES 

1 

382 

027B 

STICK3 

. RES 

1 

383 

027C 

PTRIGO 

. RES 

1 

384 

027D 

PTRIG1 

. RES 

1 

385 

027E 

PTRIG2 

. RES 

1 

386 

027F 

PTRIG3 

. RES 

1 

387 

0280 

PTRIG4 

. RES 

1 


COUNT DOWN TIMER 4 FLAG 

IAN'S TEMP (RENAMED FROM T1 BY POPULAR DEMA 

COUNT DOWN TIMER FLAG 5 

SAVE DMACTL REGISTER 

SAVE DISPLAY LIST LOW BYTE 

SAVE DISPLAY LIST HI BYTE 

SKCTL REGISTER RAM 


; LIGHT PEN HORIZONTAL VALUE 
.LIGHT PEN VERTICAL VALUE 
; BREAK KEY VECTOR 

; SPARE 

; COMMAND FRAME BUFFER - DEVICE 
; COMMAND 

; COMMAND AUX BYTE 1 
; COMMAND AUX BYTE 2 
THE LAST WORD ON A PAGE 

i TEMPORARY RAM CELL 
THE LAST WORD ON A PAGE 

i ERROR FLAG - ANY DEVICE ERROR EXCEPT TIME 0 

.DISK FLAGS FROM SECTOR ONE 
; NUMBER OF DISK BOOT SECTORS 
; ADDRESS WHERE DISK BOOT LOADER WILL BE PUT 
i COLDSTART FLAG < 1 = IN MIDDLE OF CQLDSTART ) 

i SPARE 

.DISK TIME OUT REGISTER 
.CHAR LINE BUFFER 
; GLOBAL PRIORITY CELL 
» POTENTIOMETER 0 RAM CELL 


; JOYSTICK 0 RAM CELL 


; PADDLE TRIGGER 0 



ERR LINE 

ADDR B 1 B2 B3 B4 



6500 

388 

0281 

PTRIG5 

. RES 

1 

389 

0282 

PTRIG6 

. RES 

1 

390 

0283 

PTRIG7 

. RES 

1 

391 

0284 

STRIGO 

. RES 

1 

392 

0285 

STRIG1 

. RES 

1 

393 

0286 

STRIG2 

. RES 

1 

394 

0287 

STRIG3 

. RES 

1 

395 


i 



396 

0288 

CSTAT : 

. RES 

1 

397 

0289 

WMODE: 

. RES 

1 

398 

028A 

BLIM: 

. RES 

1 

399 

028B 

I MASK: 

. RES 

1 

400 

028C 

JVECK: 

. RES 

2 

401 


i 



402 

028E 


. RES 

2 

403 





404 





405 





406 





407 

0290 

TXTRQW 

. RES 

1 

408 

0291 

TXTCOL 

. RES 

2 

409 

0293 

TINDEX 

. RES 

1 

410 

0294 

TXTMSC 

. RES 

2 

411 

0296 

TXTOLD 

. RES 

6 

412 

029C 

TMPX1: 

. RES 

1 

413 

029D 

H0LD3: 

. RES 

1 

414 

029E 

SUBTMP 

. RES 

1 

415 

029F 

H0LD2: 

. RES 

1 

416 

02A0 

DMASK: 

. RES 

1 

417 

02A1 

TMPLBT 

. RES 

1 

418 

02A2 

ESCFLG 

. RES 

1 

419 

02A3 

TABMAP 

. RES 

15 

420 

02B2 

LOGMAP 

. RES 

4 

421 

02B6 

INVFLG 

. RES 

1 

422 

02B7 

FILFLG 

. RES 

1 

423 

02B8 

TMPROW 

. RES 

1 

424 

02B9 

TMPCOL 

. RES 

2 

425 

02BB 

SCRFLG 

. RES 

1 

426 

02BC 

H0LD4: 

. RES 

1 

427 

02BD 

HOLDS: 

. RES 

1 

428 

02BE 

SHFLOK 

. RES 

1 

429 

02BF 

BOTSCR 

. RES 

1 

430 


# 



431 


i 



432 

02C0 

PCOLRO 

. RES 

1 

433 

02C 1 

PC0LR1 

. RES 

1 

434 

02C2 

PC0LR2 

. RES 

1 

435 

02C3 

PC0LR3 

. RES 

1 

436 

02C4 

COLORO 

. RES 

1 

437 

02C5 

COLOR 1 

. RES 

1 

438 

02C6 

C0L0R2 

. RES 

1 

439 

02C7 

C0L0R3 

. RES 

1 

440 

02C8 

C0L0R4 

. RES 

1 

441 


i 
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i JOYSTICK TRIGGER O 


; SPARE 


TEXT RQWCRS 
TEXT COLORS 
TEXT INDEX 

FOOLS CONVRT INTO NEW MSC 

OLDROW OLDCOL FOR TEXT (AND THEN SOME) 


i ESCAPE FLAG 

; LOGICAL LINE START BIT MAP 
; INVERSE VIDEO FLAG (TOGGLED BY ATARI KEY) 
; RIGHT FILL FLAG FOR DRAW 


i SET IF SCROLL OCCURS 
; TEMP CELL USED IN DRAW ONLY 
i DITTO 

; BOTTOM OF SCREEN : 24 NORM 4 SPLIT 


PO COLOR 
PI COLOR 
P2 COLOR 
P3 COLOR 
COLOR 0 



PAGE 10 
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442 


443 

02C9 


. RES 

23 

444 


/ 



445 


i 



446 


i 



447 

02E0 

GLBABS 

=# 


448 


i 



449 

02E0 


. RES 

4 

450 


i 



451 

02E4 

RAMSIZ 

. RES 

1 

452 

02E5 

MEMTOP 

. RES 

2 

453 

02E7 

MEMLO : 

. RES 

2 

454 

02E9 


. RES 

1 

455 

02EA 

DVSTAT 

. RES 

4 

456 

02EE 

CBAUDL 

. RES 

1 

457 

02EF 

CBAUDH 

. RES 

1 

458 


* 



459 

02F0 

CRSINH 

. RES 

1 

460 

02F1 

KEYDEL 

. RES 

1 

461 

02F2 

CHI: 

. RES 

1 

462 


t 



463 

02F3 

CHACT: 

. RES 

1 

464 

02F4 

CHBAS: 

. RES 

1 

465 


; 



466 

02F5 


. RES 

5 

467 


; 



468 

02FA 

CHAR: 

. RES 

1 

469 

02FB 

AT AC HR 

. RES 

1 

470 

02FC 

CH: 

. RES 

1 

471 

02FD 

FILDAT 

. RES 

1 

472 

02FE 

DSPFLG 

. RES 

1 

473 

02FF 

SSFLAG 

. RES 

1 

474 


: 




475 

476 

477 

478 

479 

480 


481 


/ 

PAGE 

THREE 

482 


; 



483 

0300 

DCB 

=* 


484 

0300 

DDEVIC 

. RES 

1 

485 

0301 

DUNIT: 

. RES 

1 

486 

0302 

DCOMND 

. RES 

1 

487 

0303 

DSTATS 

. RES 

1 

488 

0304 

DBUFLO 

. RES 

1 

489 

0305 

DBUFHI 

. RES 

1 

490 

0306 

DTIMLO 

. RES 

1 

491 

0307 

DUNUSE 

. RES 

1 

492 

0308 

DBYTLO 

. RES 

1 

493 

0309 

DBYTHI 

. RES 

1 

494 

030A 

DAUX1 : 

. RES 

1 

495 

030B 

DAUX2: 

. RES 

1 


; SPARE 


; GLOBAL VARIABLES 
i SPARE 

; RAM SIZE <HI BYTE ONLY) 

; TOP OF AVAILABLE USER MEMORY 
; BOTTOM OF AVAILABLE USER MEMORY 
; SPARE 

; STATUS BUFFER 

; CASSETTE BAUD RATE LOW BYTE 


i CURSOR INHIBIT (00 = CURSOR ON) 
iKEY DELAY 


; CHACTL REGISTER RAM 
; CHBAS REGISTER RAM 

i SPARE BYTES 


ATASCII CHARACTER 

GLOBAL VARIABLE FOR KEYBOARD 

RIGHT FILL DATA (DRAW) 

DISPLAY FLAG : DISPLAY CNTLS IF NON-ZERO 
START/STOP FLAG FOR PAGING (CNTL 1). CLEARE 


ASSIGNMENTS 

; DEVICE CONTROL BLOCK 
; PERIPHERAL UNIT 1 BUS I.D. NUMBER 
»UNIT NUMBER 
; BUS COMMAND 

; COMMAND TYPE/STATUS RETURN 
i DATA BUFFER POINTER LOW BYTE 

; DEVICE TIME OUT IN 1 SECOND UNITS 
; UNUSED BYTE 

i NUMBER OF BYTES TO BE TRANSFERRED LOW BYTE 
; COMMAND AUXILIARY BYTE 1 
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ERR LINE ADDR B1 B2 B3 B4 
496 


497 

030C 

TIMER1: .RES 

2 

INITIAL TIMER VALUE 

498 

030E 

ADDCOR: .RES 

1 

ADDITION CORRECTION 

499 

030F 

CASFLG: . RES 

1 

CASSETTE MODE WHEN SET 

500 

0310 

TIMER2: . RES 

2 

FINAL TIMER VALUE. THESE TWO TIMER VALUES 

501 


/ ARE 

USED TO 

COMPUTE INTERVAL FOR BAUD RATE 

502 

0312 

TEMPI 

. RES 

2 

TEMPORARY STORAGE REGISTER 

503 

0314 

TEMP2 

. RES 

1 

TEMPORARY STORAGE REGISTER 

504 

0315 

TEMP3 

. RES 

1 

TEMPORARY STORAGE REGISTER 

505 

0316 

SAVIO 

. RES 

1 

SAVE SERIAL IN DATA PORT 

506 

0317 

TIMFLG: . RES 

1 

TIME OUT FLAG FOR BAUD RATE CORRECTION 

507 

0318 

STACKP: .RES 

1 

SIO STACK POINTER SAVE CELL 

508 

0319 

TSTAT 

. RES 

1 

TEMPORARY STATUS HOLDER 

509 


/ 




510 


} 




511 


} 




512 

031 A 

HATABS: . RES 

38 

HANDLER ADDRESS TABLE 

513 

0021 

MAX DEV = 

*- HATABS-5 

MAXIMUM HANDLER ADDRESS INDEX 

514 






515 



NOTE : 

THE ENTIRE IOCB 

DEFINITIONS HAVE BEEN MODIFIED 

516 






517 


IOCB: 

. ORG 

* 

I/O CONTROL BLOCKS 

518 

0340 

ICHID 

. RES 

1 

HANDLER INDEX NUMBER (FF = IOCB FREE) 

519 

0341 

ICDNO 

. RES 

1 

DEVICE NUMBER (DRIVE NUMBER) 

520 

0342 

IGCOM 

. RES 

1 

COMMAND CODE 

521 

0343 

ICSTA 

. RES 

1 

STATUS OF LAST IOCB ACTION 

522 

0344 

ICBAL 

. RES 

1 

BUFFER ADDRESS LOW BYTE 

523 

0345 

ICBAH 

. RES 

1 


524 

0346 

ICPTL 

. RES 

1 

PUT BYTE ROUTINE ADDRESS - 1 

525 

0347 

ICPTH 

. RES 

1 


526 

0348 

ICBLL 

. RES 

1 

BUFFER LENGTH LOW BYTE 

527 

0349 

ICBLH 

. RES 

1 


528 

034A 

ICAX1 

. RES 

1 

AUXILIARY INFORMATION FIRST BYTE 

529 

034B 

ICAX2 

. RES 

1 


530 

034C 

ICSPR 

. RES 

4 

FOUR SPARE BYTES 

531 

0350 


. RES 

MAX IOC- IOC BSZ 

532 


i 




533 

03C0 

PRNBUF : .RES 

40 

/PRINTER BUFFER 

534 


/ 




535 

03E8 


. RES 

21 

SPARE BYTES 


536 

537 

538 

539 

540 

541 

542 


543 


i 

PAGE 

FOUR RAM ASSIGNMENTS 

544 


i 



545 

03FD 

CASBUF : 

. RES 

131 /CASSETTE BUFFER 

546 


i 



547 


; USER 

AREA STARTS HERE AND GOES TO END OF PAGE FIVE 

548 

0480 

USAREA: 

. RES 

128 / SPARE 


549 
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550 

551 i 

552 i 

553 ; 

554 ; 

555 ; 

556 ; PAGE FIVE RAM ASSIGNMENTS 

557 ; 

558 ; PAGE FIVE IS RESERVED AS A USER WORK SPACE 

559 i 

560 ; NOTE: SEE FLOATING POINT SUBROUTINE AREA FOR PAGE FIVE CELLS 

561 ; 

562 ; 

563 ; PAGE SIX RAM ASSIGNMENTS 

564 ; 

565 ; PAGE SIX IS RESERVED AS A USER'S USER WORK SPACE 

566 ; 

567 ; 

568 ; 

569 i 

570 i FLOATING POINT SUBROUTINES 

571 ; 


572 

0006 

FPREC 

= 

6 ; FLOATING PT PRECISION (# OF BYTES) 

573 


; IF CARRY USED 

THEN CARRY CLEAR => NO ERROR, CARR 

574 

D800 

AFP 

= 

$D800 ; ASC I I ->FLOAT I NG POINT (FP) 

575 


» 



INBUFF+C I X -> FRO, CIX, CARRY 

576 

D8E6 

FASC 

= 

$D8E6 

FP -> ASCII FRO-> LBUFF (INBUFF) 

577 

D9AA 

IFP 

= 

$D9AA 

INTEGER -> FP 

578 


i 



0-$FFFF (LSB, MSB ) IN FRO, FR0+1->FR0 

579 

D9D2 

FPI 

= 

*D9D2 

FP -> INTEGER FRO -> FRO, FRO+1, CARRY 

580 

DA60 

FSUB 

= 

*DA60 

FRO <- FRO - FR1 , CARRY 

581 

DA66 

FADD 

= 

$DA66 

FRO C- FRO + FR1 , CARRY 

582 

DADB 

FMUL 

« 

$DADB 

FRO <- FRO * FR1 .CARRY 

583 

DB28 

FDIV 

SB 

*DB28 

FRO <- FRO / FR1 .CARRY 

584 

DD89 

FLDOR 

as 

*DD89 

FLOATING LOAD REGO FRO <- (X,Y) 

585 

DD8D 

FLDOP 

as 

*DD8D 

“ " “ FRO <- ( FLPTR ) 

586 

DD98 

FLD1R 

as 

$DD98 

“ " REG1 FR1 <- ( X, Y > 

587 

DD9C 

FLD1P 

s= 

$DD9C 

“ " " FR1 <- (FLPTR) 

588 

DDA7 

FSTOR 

SB 

*DDA7 

FLOATING STORE REGO (X,Y) <- FRO 

589 

DDAB 

FSTOP 

SB 

$DDAB 

” " ” (FLPTR) <- FRO 

590 

DDB6 

FMOVE 

SB 

$DDB6 

FR1 <- FRO 

591 

DD40 

PLYEVL 

= 

*DD40 

FRO <- P(Z) = SUM ( I=N TO 0) (A(I)*Z**I) CAR 

592 


/ 


INPUT: ( X, Y ) as A(N>, A(N-1 ). . . A(0) -> PLYARG 

593 


# 



ACC * # OF COEFFICIENTS = DEGREE+1 

594 


i 



FRO « Z 

595 

DDCO 

EXP 

as 

$DDC0 

FRO <- E**FRO = EXP10(FR0 * LOGIO(E)) CARRY 

596 

DDCC 

EXP 10 

= 

f DDCC 

FRO <- 10**FR0 CARRY 

597 

DECD 

LOG 

ss 

*DECD 

FRO C- LN(FRO) = LOGIO(FRO) /LOGIO(E) CARRY 

598 

DED1 

LOG 10 

= 

$DED1 

FRO <- LOG 10 (FRO) CARRY 

599 


; THE 

FOLLOWING 

ARE IN BASIC 

CARTRIDGE: 

600 

BD81 

SIN 

as 

$BD81 

FRO C- SIN (FRO) DEGFLG=0 =>RADS, 6=>DEG. CA 

601 

BD73 

COS 

SB 

$BD73 

FRO <- COS (FRO) CARRY 

602 

BE43 

ATAN 

as 

*BE43 

FRO <- ATAN (FRO) CARRY 

603 

BEB1 

SGR 

as 

$BEB 1 

FRO <- SQUAREROOT ( FRO ) CARRY 



ERR LINE ADDR B1 B2 B3 B4 
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604 


; FLOATING POINT ROUTINES ZERO PAGE (NEEDED ONLY IF F. P. ROUTINES ARE CA 

605 



*=$D4 



606 

00D4 

FRO: 

. RES 

FPREC 

FP REGO 

607 

OODA 

FRE: 

. RES 

FPREC 


608 

OOEO 

FR1: 

. RES 

FPREC 

FP REG1 

609 

00E6 

FR2: 

. RES 

FPREC 


610 

OOEC 

FRX: 

. RES 

1 

FP SPARE 

611 

OOED 

EEXP : 

. RES 

1 

VALUE OF E 

612 

OOEE 

NSIGN: 

. RES 

1 

SIGN OF # 

613 

OOEF 

ESIGN: 

. RES 

1 

SIGN OF EXPONENT 

614 

OOFO 

FCHRFLG- 

. RES 

1 

1ST CHAR FLAG 

615 

00F1 

DIGRT: 

. RES 

1 

# OF DIGITS RIGHT OF DECIMAL 

616 

00F2 

C I X : 

. RES 

1 

CURRENT INPUT INDEX 

617 

00F3 

INBUFF: 

. RES 

2 

POINTS TO USER'S LINE INPUT BUFFER 

618 

OOFS 

ZTEMP1: 

. RES 

2 


619 

00F7 

Z TEMP 4: 

. RES 

2 


620 

00F9 

ZTEMP3: 

. RES 

2 


621 

OOFB 

DEGFLG 




622 

OOFB 

RADFLG: 

. RES 

1 

0=RADI ANS/ 6=DEGREES 

623 

0000 

RADON 

= 

0 

INDICATES RADIANS 

624 

0006 

DEGON 

= 

6 

INDICATES DEGREES 

625 

OOFC 

FLPTR : 

. RES 

2 

POINTS TO USER'S FLOATING PT NUMBER 


626 OOFE FPTR2: . RES 2 

627 i FLOATING PT ROUTINES' NON-ZERO PAGE RAM 

628 i (NEEDED ONLY IF F. P. ROUTINES CALLED) 


629 

630 

057E 

LBPR1 : 

*=$57E 
. RES 

1 

LBUFF PREFIX 1 

631 

057F 

LBPR2: 

. RES 

1 

LBUFF PREFIX 2 

632 

0580 

LBUFF : 

. RES 

128 

LINE BUFFER 

633 

05E0 

PLYARG 

= 

LBUFF+*60 

POLYNOMIAL ARGUMENTS 

634 

05E6 

FPSCR 

SB 

PLYARG+FPREC 


635 

05EC 

FPSCR1 

= 

FPSCR+FPREC 


636 

OSE6 

FSCR 

= 

FPSCR 


637 

05EC 

FSCR1 

S= 

FPSCR 1 


638 

05FF 

LBFEND 

SB 

*-l 

END OF LBUFF 


639 i 

640 

641 ; 

642 

643 i 

644 * 

645 i 

646 i 

647 ; 

648 ; COLLEEN MNEMONICS 

649 ; 


650 

D200 

POKEY 

sr 

*D200 

VBLANK ACTION: 

DESCRIPTION: 


651 

D200 

POTO 

ss 

PQKEY+O 

POTO- 

->PADDLO 

0-227 

IN RAM 

CELL 

652 

D201 

P0T1 

SB 

POKEY+1 

P0T1- 

->PADDL1 

0-227 

IN RAM 

CELL 

653 

D202 

P0T2 

ss 

POKEY+2 

P0T2- 

->PADDL2 

0-227 

IN RAM 

CELL 

654 

D203 

P0T3 

SB 

POKEY+3 

P0T3- 

->PADDL3 

0-227 

IN RAM 

CELL 

655 

D204 

P0T4 

SB 

POKEY+4 

P0T4- 

->PADDL4 

0-227 

IN RAM 

CELL 

656 

D205 

P0T5 

SB 

POKEY+5 

P0T5- 

->PADDL5 

0-227 

IN RAM 

CELL 

657 

D206 

P0T6 

BS 

POKEY+6 

P0T6- 

->PADDL6 

0-227 

IN RAM 

CELL 



ERR LINE ADDR B1 B2 B3 B4 


658 

D207 

P0T7 

= 

659 

D208 

ALLPOT 

= 

660 

D209 

KBCODE 

= 

661 

D20A 

RANDOM 

= 

662 

D20B 

POTGO 

= 

663 

D20D 

SERIN 

= 

664 

D20E 

IRQST 

= 

665 

D20F 

SKSTAT 

ss 

666 

D200 

AUDF1 

= 

667 

D201 

AUDC 1 

= 

668 

D202 

AUDF2 

= 

669 

D203 

AUDC2 

= 

670 

D204 

AUDF3 

= 

671 

D205 

AUDC3 

= 

672 

D206 

AUDF4 

= 

673 

D207 

AUDC 4 

ss 

674 

D208 

AUDCTL 

ss 

675 

D209 

STIMER 

= 

676 

D20A 

SKRES 

ss 

677 

D20D 

SEROUT 

= 

678 

D20E 

IRQEN 

SS 

679 

D20F 

SKCTL 

ss 

680 


# 


681 

DOOO 

CTIA 

ss 

682 

DOOO 

HPOSPO 

ss 

683 

D001 

HP0SP1 

= 

684 

D002 

HP0SP2 

SS! 

685 

D003 

HP OSP 3 

SS 

686 

D004 

HPOSMO 

= 

687 

D005 

HP0SM1 

ss 

688 

D006 

HP0SM2 

ss 

689 

D007 

HP0SM3 

ss 

690 

D008 

SIZEPO 

= 

691 

D009 

SIZEP1 

= 

692 

DOOA 

SIZEP2 

= 

693 

DOOB 

SIZEP3 

= 

694 

DOOC 

SIZEM 

ss 

695 

DOOD 

GRAFPO 

= 

696 

DOOE 

GRAFP1 

SS 

697 

DOOF 

GRAFP2 

= 

698 

D010 

GRAFP3 

= 

699 

D01 1 

GRAFM 

SS 

700 

DO 12 

COLPMO 

= 

701 

DO 13 

C0LPM1 

SS 

702 

DO 14 

C0LPM2 

SS 

703 

D01 5 

COLPMO 

= 

704 

DO 16 

COLPFO 

SS 

705 

DO 17 

C0LPF1 

SS 

706 

D018 

C0LPF2 

= 

707 

DO 19 

C0LPF3 

= 

708 

D01 A 

COLBK 

= 

709 

DO IB 

PRIOR 

= 

710 

DO 1C 

VDELAY 

SS 

711 

DO ID 

GRACTL 

SS 
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POKEY+7 

P0T7 — >PADDL7 

POKEY+8 

??? 

PQKEY+9 


POKE Y+ 10 


POKEY+11 

STROBED 

PQKEY+13 


POKEY+14 


POKEY+15 


POKEY+O 


POKEY+1 


POKEY+2 


POKEY+3 


POKEY+4 


PQKEY+5 


POKEY+6 


POKEY+7 


POKEY+8 

NONE 

POKEY+9 


POKE Y+ 10 

NONE 

POKEY+13 

NONE 

PQKEY+14 

POKMSK — > IRQEN 

POKEY+15 

SSKCTL — >SKCTL 

*D000 

VBLANK ACTION: 

CTIA+O 


CTIA+1 


CTIA+2 


CTIA+3 


CTIA+4 


CTIA+5 


CTIA+6 


CTIA+7 


CTIA+8 


CTIA+9 


CTIA+10 


CTIA+1 1 


CTIA+12 


CTIA+13 


CTIA+14 


CTIA+15 


CTIA+16 


CTIA+17 


CTIA+18 

PCOLRO — >COLPMO 

CTIA+1 9 

PC0LR1 — >C0LPM1 

CTIA+20 

PC0LR2 — >C0LPM2 

CTIA+21 

PC0LR3 — >CQLPM3 

CTIA+22 

COLORO — >CQLPFG 

CTIA+23 

COLOR 1 — >C0LPF1 

CTIA+24 

C0L0R2 — >C0LPF2 

CTIA+25 

COLORS — >C0LPF3 

CTIA+26 

COLOR 4 — >COLBK 

CTIA+27 

(ON OPEN S: OR 

CTIA+28 


CTIA+29 



0-227 IN RAM CELL 


AUDC TL< — C S 1 0 1 

SKRES< — CSIOD 
SEROUTC — CSI03 
AFFECTED BY OPEN S: OR E: ) 
SSKCTLC — CSI03 

DESCRIPTION: 


WITH ATTRACT MODE 
WITH ATTRACT MODE 
WITH ATTRACT MODE 
WITH ATTRACT MODE 
WITH ATTRACT MODE 
WITH ATTRACT MODE 
WITH ATTRACT MODE 
WITH ATTRACT MODE 
WITH ATTRACT MODE 
: ) GPRIOR — >PRIOR 



ERR LINE ADDR B1 B2 B3 B4 


712 DO IE 

713 DO IF 

714 DOOO 

715 DOOl 

716 D002 

717 D003 

718 D004 

719 D005 

720 D006 

721 D007 

722 D008 

723 D009 

724 DOOA 

725 DOOB 

726 DOOC 

727 DOOD 

728 DOOE 

729 DOOF 

730 DO 10 

731 DOU 

732 DO 12 

733 DO 13 

734 

735 D400 

736 D400 

737 D401 

738 D402 

739 D403 

740 D404 

741 D405 

742 D407 

743 D409 

744 D40A 

745 D40B 

746 D40C 

747 D40D 

748 D40E 

749 D40F 

750 D40F 

751 D300 

752 D300 

753 D301 

754 D302 

755 D303 

756 

757 

758 

759 


HITCLR = 

CONSOL = 

MOPF 

M1PF 

M2PF 

M3PF 

POPF 

P1PF 

P2PF 

P3PF 

MOPL 

M1PL 

M2PL 

M3PL 

POPL 

P1PL = 

P2PL 

P3PL 

TR 100 

TRIG1 

TRIG2 

TRIG3 

i 

ANTIC 
DMACTL = 
CHACTL * 
DLISTL = 
DLISTH = 
HSCROL = 
VSCRQL = 
PMBASE * 
CHBASE = 
UISYNC = 
VCQUNT = 
PENH 
PENV 
NMIEN 
NMIRES = 
NMIST 
PI A 
PORTA 
PORTB 
PACTL 


; . PAGE 
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CTIA+30 

CTIA+31 i *08 — >CONSOL TURN OFF SPEAKER 

CTIA+O 

CTI A+l 

CTIA+2 

CTIA+3 

CTI A+4 

CTIA+5 

CTIA+6 

CTIA+7 

CTIA+8 

CTIA+9 

CTIA+10 

CTIA+11 

CTIA+12 

CTIA+13 

CTIA+14 

CTIA+15 

CTIA+16 iTRIGO — >STRIG0 

CTIA+17 ; TRIG1 — >STRIG1 

CTIA+18 i TRIG2 — >STRIG2 

C T I A+ 1 9 i TR I G3 — >STR I G3 

*D400 ; VBLANK ACTION DESCRIPTION 

ANTIC+O ; DMACTLC — SDMCTL ON OPEN S: OR E: 

ANTIC+1 ; CHACTLC — CHACT ON OPEN S: OR E: 

ANTIC +2 ' ; DLISTLC — SDLSTL ON OPEN S: OR E: 

ANTIC +3 ; DLISTHC — SDLSTH ON OPEN S: OR E: 

ANTIC+4 
ANTIC+5 
ANTIC+7 

ANTIC+9 ; CHBASEC — CHBAS ON OPEN S: OR E: 

ANTIC+10 

ANTIC+1 1 

ANTIC+1 2 

ANTIC+13 

ANTIC+14 ; NMIEN< — 40 POWER ON AND CSETVBVD 

ANTIC+1 5 ; STROBED 

ANTIC+1 5 

*D300 ; VBLANK ACTION DESCRIPTION 

PIA+O ; PORTA — >STICKO, 1 X-Y CONTROLLERS 

PIA+1 ; PORTB — >STICK2, 3 X-Y CONTROLLERS 

PIA+2 iNONE PACTL< — 3C UNIT] 

PIA+3 iNONE PBCTLC — 3C CINIT3 



ERR LINE 


ADDR 81 B2 B3 B4 
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760 

761 

762 

763 

764 

0030 

# 

ASCZER 

. PAGE 
LIST 
. TITLE 

S 

'CENTRAL 

UPDATED 

'0 

INPUT/OUTPUT (CIO) 2-7-79 
BY AL MILLER 3-9-79 
; ASCII ZERO 

765 

003A 

COLON 

= 

*3A 

; ASCII COLON 

766 

009B 

EOL 

= 

$9B 

i END OF RECORD 
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CENTRAL INPUT/OUTPUT (CIO) 2-7-79 


PAGE 


17 


767 

768 

769 

770 

771 E456 4C C4 E4 

772 

773 

774 

775 E46E 4C A6 E4 

776 

777 

778 

779 

780 

781 

782 

783 

784 


. PAGE 

/ 

; CIO JUMP VECTOR FOR USERS 
*=CIOV 

JMP CIO ; GO TO CIO 

9 

i CIO INIT JUMP VECTOR FOR POWER UP 
*=CIOINV 

JMP C 1 0 1 NT i GO TO INIT 


ERROR ROUTINE ADDRESS EQUATE 

ERRTNH =ERRTN/256 "MOVED TO LINE 788" 

ERRTNL =-ERRTNH*256+ERRTN "MOVED TO LINE 789" 


*=CIOORG 


785 





; CIO INITIALIZATION (CALLED 

BY MONITOR AT POWER 

UP) 

786 

E4A6 

A2 

00 


CIGINT: 

LDX 

#0 



787 

E4A8 

A9 

FF 


CI0I1: 

LDA 

#IOCFRE ; 

SET ALL IQCB'S TO FREE 

788 

E4AA 

9D 

40 

03 


STA 

ICHID, X ; 

BY SETTING HANDLER 

ID'S=*FF 

789 

E4AD 

A9 

CO 



LDA 

#£RRTNL 



790 

E4AF 

9D 

46 

03 


STA 

ICPTL/ X ; 

POINT PUT TO ERROR 

ROUTINE 

791 

E4B2 

A9 

E4 



LDA 

#ERRTNH 



792 

E4B4 

9D 

47 

03 


STA 

ICPTH. X 



793 

E4B7 

8A 




TXA 




794 

E4B8 

18 




CLC 




795 

E4B9 

69 

10 



ADC 

#IOCBSZ ; 

BUMP INDEX BY SIZE 


796 

E4BB 

AA 




TAX 




797 

E4BC 

C9 

80 



CMP 

#MAX IOC 

DONE? 


798 

E4BE 

90 

E8 



BCC 

CI0I1 

NO 


799 

E4C0 

60 




RTS 


YES. RETURN 


800 





; 





801 





j ERROR 

ROUTINE 

FOR ILLEGAL PUT 


802 

E4C0 




ERRTN 

=*-l 




803 

00E4 




ERRTNH 

=ERRTN/256 



804 

OOCO 




ERRTNL 

= ( -ERRTNH > *256+ERRTN 



805 

E4C1 

AO 

85 



LDY 

#NOTOPN ; 

IOCB NOT OPEN 


806 

E4C3 

60 




RTS 






ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

CENTRAL INPUT/OUTPUT <CIO> 


2-7-79 

807 





. PAGE 




808 





i 





809 





i CIO LOCAL 

RAM (USES SPARE 

BYTES IN ZERO PAGE IOCB) 

810 

002C 




ENTVEC = 

ICSPRZ 




811 





f 





812 





i CIO MAIN ROUTINE 




813 





j 





814 





; CIO INTERFACES BETWEEN 

USER AND INPUT/OUTPUT DE 

815 

E4C4 

85 

2F 


CIO: STA 

C IOC HR 



SAVE POSSIBLE OUTPUT CHARACTER 

816 

E4C6 

86 

2E 


STX 

ICIDNO 



SAVE IOCB NUMBER * N 

817 





/ 





818 





; CHECK FOR 

LEGAL IOCB 




819 

E4C8 

8A 



TXA 





820 

E4C9 

29 

OF 


AND 

#*F 



IS IOCB MULTIPLE OF 16? 

821 

E4CB 

DO 

04 


BNE 

CIERR1 



NO, ERROR 

822 

E4CD 

EO 

80 


CPX 

#MAX IOC 



IS INDEX TOO LARGE? 

823 

E4CF 

90 

05 


BCC 

I0C1 



NO 

824 





t 





825 





i INVALID IOCB NUMBER — 

RETURN ERROR 

826 

E4D1 

AO 

86 


CIERR1: LDY 

#BADIOC 



ERROR CODE 

827 

E4D3 

4C 

IB 

E6 

JMP 

CIRTN1 



RETURN 

828 





t 





829 





i MOVE USER 

IOCB TO ZERO 

PAGE 

830 

E4D6 

AO 

00 


I OC 1 : LDY 

#0 




831 

E4D8 

BD 

40 

03 

I0C1A: LDA 

IOCB, X 



USER IOCB 

832 

E4DB 

99 

20 

00 

STA 

IOCBAS, Y 



TO ZERO PAGE 

833 

E4DE 

E8 



INX 





834 

E4DF 

C8 



I NY 





835 

E4E0 

CO 

OC 


CPY 

#12 



12 BYTES 

836 

E4E2 

90 

F4 


BCC 

IOC 1 A 




837 





i 





838 





; COMPUTE CIO INTERNAL VECTOR FOR COMMAND 

839 

E4E4 

AO 

84 


LDY 

#NVALID 



ASSUME INVALID CODE 

840 

E4E6 

A5 

22 


LDA 

ICCOMZ 



COMMAND CODE TO INDEX 

841 

E4E8 

C9 

03 


CMP 

#QPEN 



IS COMMAND LEGAL? 

842 

E4EA 

90 

25 


BCC 

CIERR4 



NO 

843 

E4EC 

AS 



TAY 





844 





; 





845 





; MOVE COMMAND TO ZERO BASE 

FOR INDEX 

846 

E4ED 

CO 

OE 


CPY 

#SPEC IL 



IS COMMAND SPECIAL? 

847 

E4EF 

90 

02 


BCC 

IOC 2 



NO 

848 

E4F1 

AO 

OE 


LDY 

#SPEC IL 



YES, SET SPECIAL OFFSET INDEX 

849 

E4F3 

84 

17 


I0C2: STY 

ICCOMT 



SAVE COMMAND FOR VECTOR 

850 

E4F5 

B9 

C6 

E6 

LDA 

COMTAB-3, 

Y 


GET VECTOR OFFSET FROM TABLE 

851 

E4F8 

FO 

OF 


BEG 

CIOPEN 



GO IF OPEN COMMAND 

852 

E4FA 

C9 

02 


CMP 

#2 



IS IT CLOSE? 

853 

E4FC 

FO 

35 


BEG 

CICLOS 



YES 

854 

E4FE 

C9 

08 


CMP 

#8 



IS IT STATUS OR SPECIAL? 

855 

E500 

BO 

4C 


BCS 

CISTSP 



YES 

856 

E502 

C9 

04 


CMP 

#4 



IS IT READ? 

857 

E504 

FO 

63 


BEG 

CIREAD 



YES 

858 

E506 

4C 

C9 

E5 

JMP 

CIWRIT 



ELSE, MUST BE WRITE 


18 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

CENTRAL 

INPUT /OUTPUT (CIO) 

2-7-79 

859 






. PAGE 



860 









861 





OPEN COMMAND 



862 









863 





FIND DEVICE HANDLER IN HANDLER ADDRESS TABLE 

864 

E509 

A5 

20 

Cl OPEN: 

LDA 

ICHIDZ 

; GET HANDLER ID 

865 

E50B 

C9 

FF 



CMP 

#IOCFRE 

i IS THIS IOCB CLOSED? 

866 

E50D 

F0 

05 



BEG 

I0C6 

i YES 

867 









868 





ERROR 

-- IOCB 

ALREADY OPEN 

869 

E50F 

AO 

81 

CIERR3: 

LDY 

#PRVOPN 

; ERROR CODE 

870 

E51 1 

4C 

IB 

E6 CIERR4: 

JMP 

CIRTN1 

; RETURN 

871 









872 





GO FIND DEVICE 


873 

E514 

20 

9E 

E6 

I0C6: 

JSR 

DEVSRC 

;CALL DEVICE SEARCH 

874 

E517 

BO 

F8 



BCS 

CIERR4 

i GO IF DEVICE NOT FOUND 

875 





' 




876 





DEVICE FOUND, 

INITIALIZE 

IOCB FOR OPEN 

877 









878 





COMPUTE HANDLER ENTRY POINT 

879 

E519 

20 

3D 

E6 

I0C7: 

JSR 

COMENT 


880 

E51C 

BO 

F3 



BCS 

CIERR4 

i GO IF ERROR IN COMPUTE 

881 









882 





GO TO 

HANDLER 

FOR INITIALIZATION 

883 

E51E 

20 

89 

E6 

/ 

JSR 

GOHAND 

; USE INDIRECT JUMP 

884 









885 





STORE 

PUT BYTE ADDRESS- 1 

INTO IOCB 

886 

E521 

A9 

OB 



LDA 

#PUTCHR 

i SIMULATE PUT CHARACTER 

887 

E523 

85 

17 



STA 

ICCOMT 


888 

E525 

20 

3D 

E6 


JSR 

COMENT 

; COMPUTE ENTRY POINT 

889 

E528 

A5 

2C 



LDA 

ICSPRZ 

i MOVE COMPUTED VALUE 

890 

E52A 

85 

26 



STA 

ICPTLZ 

; TO PUT BYTE ADDRESS 

891 

E52C 

A5 

2D 



LDA 

ICSPRZ+1 


892 

E52E 

85 

27 



STA 

ICPTHZ 


893 

E530 

4C 

ID 

E6 


JMP 

CIRTN2 

; RETURN TO USER 


19 



ERR LINE 

ADDR 

B1 

B2 

B3 B4 

CENTRAL INPUT /OUTPUT (CIO) 

2-7-79 

894 






. PAGE 



895 





/ 




896 





; 




897 





; CLOSE 

COMMAND 



898 

E533 

AO 

01 


CICLOS: 

LDY 

#SUCCES 

ASSUME GOOD CLOSE 

899 

E535 

84 

23 



STY 

ICSTAZ 


900 

E537 

20 

3D 

E6 


JSR 

COMENT 

COMPUTE HANDLER ENTRY POINT 

901 

E53A 

BO 

03 



BCS 

CICL02 

GO IF ERROR IN COMPUTE 

902 

E53C 

20 

89 

E6 


JSR 

GOHAND 

GO TO HANDLER TO CLOSE DEVICE 

903 

E53F 

A9 

FF 


CICL02: 

LDA 

#IOCFRE 

GET IOCB "FREE" VALUE 

904 

E541 

85 

20 



STA 

ICHIDZ 

SET HANDLER ID 

905 

E543 

A9 

E4 



LDA 

#ERRTNH 


906 

E545 

85 

27 



STA 

ICPTHZ 

SET PUT BYTE TO POINT TO ERROR 

907 

E547 

A9 

CO 



LDA 

#ERRTNL 


908 

E549 

85 

26 



STA 

ICPTLZ 


909 

E54B 

4C 

ID 

E6 


JMP 

CIRTN2 

RETURN 

910 





f 




911 





} 




912 





! STATUS AND SPECIAL REQUESTS 

913 





; DO IMPLIED OPEN IF NECESSARY AND GO TO DEVICE 

914 

E54E 

A5 

20 


CISTSP: 

LDA 

ICHIDZ 

IS THERE A HANDLER ID? 

915 

E550 

C9 

FF 



CMP 

#IOCFRE 


916 

E552 

DO 

05 



BNE 

CIST1 

YES 

917 





i 




918 





i IOCB 

IS FREE/ 

DO IMPLIED OPEN 

919 

E554 

20 

9E 

E6 


JSR 

DEVSRC 

FIND DEVICE IN TABLE 

920 

E557 

BO 

B8 



BCS 

CIERR4 

GO IF ERROR IN COMPUTE 

921 





; 




922 





; COMPUTE AND GO TO ENTRY POINT IN HANDLER 

923 

E559 

20 

3D 

E6 

CIST1: 

JSR 

COMENT 

/COMPUTER HANDLER ENTRY VECTOR 

924 

E55C 

20 

89 

E6 


JSR 

GOHAND 

GO TO HANDLER 

925 





i 




926 





i RESTORE HANDLER INDEX (DO 

IMPLIED CLOSE) 

927 

E55F 

A6 

2E 



LDX 

ICIDNO 

IOCB INDEX 

928 

E561 

BD 

40 

03 


LDA 

ICHID, X 

GET ORIGINAL HANDLER ID 

929 

E564 

85 

20 



STA 

ICHIDZ 

RESTORE ZERO PAGE 

930 

E566 

4C 

ID 

E6 


JMP 

CIRTN2 

RETURN 


20 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

CENTRAL INPUT/OUTPUT (CIO) 

2-7-79 

931 





. PAGE 



932 





/ 



933 





; READ — DO GET COMMANDS 


934 

E569 

A5 

22 


CIREAD: LDA 

ICC0M2 

GET COMMAND BYTE 

935 

E56B 

25 

2A 


AND 

ICAX1Z 

IS THIS READ LEGAL? 

936 

E56D 

DO 

05 


BNE 

RCI1A 

YES 

937 





; 



938 





; ILLEGAL READ 

— IOCB OPENED FOR WRITE ONLY 

939 

E56F 

AO 

83 


LDY 

#WRONLY 

ERROR CODE 

940 

E571 

4C 

IB 

E6 

RCI1B: JMP 

CIRTN1 

RETURN 

941 





i 



942 





i COMPUTE AND CHECK ENTRY POINT 

943 

E574 

20 

3D 

E6 

RCI1A: JSR 

COMENT 

COMPUTE ENTRY POINT 

944 

E577 

BO 

F8 


BCS 

RC I IB 

GO IF ERROR IN COMPUTE 

945 





i 



946 





; GET RECORD OR 

CHARACTERS 


947 

E579 

A5 

28 


LDA 

ICBLLZ 


948 

E57B 

05 

29 


ORA 

ICBLLZ+1 

IS BUFFER LENGTH ZERO? 

949 

E57D 

DO 

08 


BNE 

RC 13 

NO 

950 

E57F 

20 

89 

E6 

JSR 

GOHAND 


951 

E582 

85 

2F 


STA 

C IOC HR 


952 

E584 

4C 

ID 

E6 

JMP 

CIRTN2 


953 





« 



954 

« 




; LOOP TO FILL 

BUFFER OR END 

RECORD 

955 

E587 

20 

89 

E6 

RC 13: JSR 

GOHAND 

GO TO HANDLER TO GET BYTE 

956 

E58A 

85 

2F 


STA 

C IOC HR 

SAVE BYTE 

957 

E58C 

30 

35 


BMI 

RC 14 

END TRANSFER IF ERROR 

958 

E58E 

AO 

00 


LDY 

#0 


959 

E590 

91 

24 


STA 

< ICBALZ), Y 

PUT BYTE IN USER BUFFER 

960 

E592 

20 

70 

E6 

JSR 

INCBFP 

INCREMENT BUFFER POINTER 

961 

E595 

AS 

22 


LDA 

ICCOMZ 

GET COMMAND CODE 

962 

E597 

29 

02 


AND 

#2 

IS IT GET RECORD? 

963 

E599 

DO 

OC 


BNE 

RC 1 1 

NO 

964 





I 



965 





; CHECK FOR EOL 

ON TEXT RECORDS 

966 

E59B 

A5 

2F 


LDA 

C IOC HR 

GET BYTE 

967 

E59D 

C9 

9B 


CMP 

#EOL 

IS IT AN EOL? 

968 

E59F 

DO 

06 


BNE 

RC 1 1 

NO 

969 

E5A1 

20 

63 

E6 

JSR 

DECBFL 

YES/ DECREMENT BUFFER LENGTH 

970 

E5A4 

4C 

C3 

E5 

JMP 

RC 14 

END TRANSFER 

971 








972 





; CHECK BUFFER 

FULL 


973 

E5A7 

20 

63 

E6 

RC I 1 ; JSR 

DECBFL 

DECREMENT BUFFER LENGTH 

974 

E5AA 

DO 

DB 


BNE 

RC 13 ; CONTINUE IF NON ZERO 



ERR LINE ADDR B1 B2 B3 B4 


CENTRAL INPUT/OUTPUT (CIO) 2-7-79 


PAGE 22 


975 






. PAGE 




976 





i 





977 





i BUFFER FULL, 

RECORD NOT 

ENDED 

978 





; DISCARD BYTES 

UNTIL END 

OF RECORD 

979 

E5AC 

A5 

22 


RC 12: 

LDA 

ICCOMZ 


; GET COMMAND BYTE 

980 

E5AE 

29 

02 



AND 

#2 


; IS IT GET CHARACTER? 

981 

E5B0 

DO 

11 



BNE 

RC 14 


,• YES, END TRANSFER 

982 





i 





983 





i LOOP 

TO WAIT 

FOR EOL 



984 

E5B2 

20 

89 

E6 

RC 16: 

JSR 

GOHAND 


; GET BYTE FROM HANDLER 

985 

E5B5 

85 

2F 



STA 

C IOC HR 


; SAVE CHARACTER 

986 

E5B7 

30 

OA 



BMI 

RC 14 


; GO IF ERROR 

987 





} 





988 





; TEXT 

RECORD, 

WAIT FOR 

EOL 

989 

E5B9 

A5 

2F 



LDA 

CIOCHR 


; GET GOT BYTE 

990 

E5BB 

C9 

9B 



CMP 

#EOL 


J IS IT EOL? 

991 

E5BD 

DO 

F3 



BNE 

RC 16 


; NO, CONTINUE 

992 





; 





993 





; END OF RECORD 

, BUFFER 

FULL — SEND TRUNCATED RECORD 

994 

E5BF 

A9 

89 


RC 1 1 1 : 

LDA 

#TRNRCD 


; ERROR CODE 

995 

ESC 1 

85 

23 



STA 

ICSTAZ 


; STORE IN IOCB 

996 





i 





997 





i TRANSFER DONE 




998 

E5C3 

20 

77 

E6 

RC 14: 

JSR 

SUBBFL 


; SET FINAL BUFFER LENGTH 

999 

E5C6 

4C 

ID 

E6 


JMP 

CIRTN2 


; RETURN 



ERR LINE ADDR B1 B2 B3 B4 


CENTRAL INPUT /OUTPUT (CIO) 2-7-79 


PAGE 23 


1000 . PAGE 

1001 i 

1002 ; WRITE — DO PUT COMMANDS 


1003 

E5C9 

A5 

22 


CIWRIT: 

LDA 

ICCOMZ 

GET COMMAND BYTE 

1004 

ESCB 

25 

2A 



AND 

ICAX1Z 

IS THIS WRITE LEGAL? 

1005 

E5CD 

DO 

05 



BNE 

WCI1A 

YES 

1006 





i 




1007 





i ILLEGAL WRITE 

— DEVICE OPENED FOR READ ONLY 

1008 

E5CF 

AO 

87 



LDY 

#RDQNLY 

ERROR CODE 

1009 

ESDI 

4C 

IB 

E6 

WCI1B: 

JMP 

CIRTN1 

RETURN 

1010 









1011 





; COMPUTE AND CHECK ENTRY POINT 

1012 

E5D4 

20 

3D 

E6 

WCI1A: 

JSR 

COMENT 

COMPUTE HANDLER ENTRY POINT 

1013 

E5D7 

BO 

F8 



BCS 

WC I IB 

GO IF ERROR IN COMPUTE 

1014 





/ 




1015 





i PUT RECORD OR 

CHARACTERS 


1016 

E5D9 

A5 

28 



LDA 

ICBLLZ 


1017 

E5DB 

05 

29 



ORA 

ICBLLZ+1 

IS BUFFER LENGTH ZERO? 

1018 

E5DD 

DO 

06 



BNE 

WC 13 

NO 

1019 

E5DF 

A5 

2F 



LDA 

C IOC HR 

GET CHARACTER 

1020 

E5E1 

E6 

28 



INC 

ICBLLZ 

SET BUFFER LENGTH=1 

1021 

E5E3 

DO 

06 



BNE 

WC 1 4 

THEN JUST TRANSFER ONE BYTE 

1022 





I 




1023 





; ' LOOP 

TO TRANSFER BYTES FROM BUFFER TO HANDLER 

1024 

E5E5 

AO 

00 


WC 13: 

LDY 

#0 


1025 

E5E7 

B1 

24 



LDA 

( ICBALZ), Y 

GET BYTE FROM BUFFER 

1026 

E5E9 

85 

2F 



STA 

CIOCHR 

SAVE 

1027 

E5EB 

20 

89 

E6 

WC 14: 

JSR 

GOHAND 

GO PUT BYTE 

1028 

E5EE 

30 

25 



BMI 

WC 1 5 

END IF ERROR 

1029 

E5F0 

20 

70 

E6 


JSR 

INCBFP 

INCREMENT BUFFER POINTER 

1030 





/ 




1031 





i CHECK 

FOR TEXT RECORD 


1032 

E5F3 

A5 

22 



LDA 

ICCOMZ 

GET COMMAND BYTE 

1033 

E5F5 

29 

02 



AND 

#2 

IS IT PUT RECORD? 

1034 

E5F7 

DO 

OC 



BNE 

WCI1 

NO 

1035 





; 




1036 





i TEXT 

RECORD — 

- CHECK FOR EOL TRANSFER 

1037 

E5F9 

A5 

2F 



LDA 

CIOCHR 

GET LAST CHARACTER 

1038 

E5FB 

C9 

9B 



CMP 

#£0L 

IS IT AN EOL? 

1039 

E5FD 

DO 

06 



BNE 

WCI1 

NO 

1040 

E5FF 

20 

63 

E6 


JSR 

DECBFL 

DECREMENT BUFFER LENGTH 

1041 

E602 

4C 

15 

E6 


JMP 

WC 15 

END TRANSFER 

1042 





i 




1043 





; CHECK 

FOR BUFFER EMPTY 


1044 

E605 

20 

63 

E6 

WCI1: 

JSR 

DECBFL 

DECREMENT BUFFER LENGTH 

1045 

E608 

DO 

DB 



BNE 

WC 13 

CONTINUE IF NON ZERO 



ERR LINE 

ADDR 

51 

52 

53 54 

CENTRAL INPUT/OUTPUT (CIO) 

2-7-79 

1046 

1047 






. PAGE 



1048 





i BUFFER EMPTY, 

RECORD NOT 

FILLED 

1049 





i CHECK TYPE OF 

TRANSFER 


1050 

E60A 

A5 

22 


WC 12: 

LDA 

ICCOMZ 

i GET COMMAND CODE 

1051 

E60C 

29 

02 



AND 

#2 

/ IS IT PUT CHARACTER? 

1052 

1053 

E60E 

DO 

05 


t 

BNE 

WCI5 

i YES, END TRANSFER 

1054 





i PUT 

RECORD (TEXT), BUFFER 

EMPTY, SEND EOL 

1055 

E610 

A9 

95 



LDA 

#EOL 


1056 

1057 

E612 

20 

89 

E6 

i 

JSR 

GQHAND 

; GO TO HANDLER 

1058 





; END 

PUT TRANSFER 


1059 

E61 5 

20 

77 

E6 

WC 15: 

JSR 

SUBBFL 

; SET ACTUAL PUT BUFFER LENGTH 

1060 

E618 

4C 

ID 

E& 


JMP 

CIRTN2 

; RETURN 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

CENTRAL INPUT/OUTPUT (CIO) 

2-7-79 

1061 

1062 






. PAGE 



1063 





; CIO 

RETURNS 



1064 





; RETURNS WITH 

Y=STATUS 


1065 

1066 

E61B 

84 

23 


CIRTN1 

f 

: STY 

ICSTAZ 

SAVE STATUS 

1067 





i RETURNS WITH 

STATUS STORED 

IN ICSTAZ 

1068 





i MOVE 

IOCB IN 

ZERO PAGE BACK TO USER AREA 

1069 

E61D 

A4 

2E 


CIRTN2 

: LDY 

ICIDNQ 

GET IOCB INDEX 

1070 

E61F 

B9 

44 

03 


LDA 

ICBAL, Y 

- 

1071 

E622 

85 

24 



STA 

ICBALZ 

RESTORE USER BUFFER POINTER 

1072 

E624 

B9 

45 

03 


LDA 

ICBAH, Y 


1073 

E627 

85 

25 



STA 

ICBAHZ 


1074 

E629 

A2 

00 



LDX 

#0 

LOOP COUNT AND INDEX 

1075 

E62B 

B5 

20 


CIRT3: 

LDA 

IOCBAS, X 

ZERO PAGE 

1076 

E62D 

99 

40 

03 


STA 

IOCB, Y 

TO USER AREA 

1077 

E630 

E8 




INX 



1078 

E631 

C8 




INY 



1079 

E632 

E0 

OC 



CPX 

#12 

12 BYTES 

1080 

1081 

E634 

90 

F5 


/ 

BCC 

CIRT3 


1082 





} RESTORE A/ X, 

9y. Y 


1083 

E636 

A5 

2F 



LDA 

C IOC HR 

GET LAST CHARACTER 

1084 

E638 

A6 

2E 



LDX 

ICIDNO 

IOCB INDEX 

1085 

E63A 

A4 

23 



LDY 

ICSTAZ 

GET STATUS AND SET FLAGS 

1086 

E63C 

60 




RTS 


RETURN TO USER 


PAGE 



ERR LINE 

ADDR 

B1 

B2 

B3 B4 

CENTRAL INPUT/OUTPUT (CIO) 

2-7-79 

1087 






. PAGE 



1088 

1089 










1090 





CIO 

SUBROUTINES 


1091 










1092 





i COMENT — 

CHECK AND COMPUTE HANDLER ENTRY POINT 

1093 

E63D 

A4 

20 

CQMENT 

: LDY 


ICHIDZ 

; GET HANDLER INDEX 

1094 

E63F 

CO 

22 



CPY 


#MAXDEV+1 

; IS IT A LEGAL INDEX? 

1095 

1096 

E641 

90 

04 



BCC 


C0M1 

; YES 

1097 





ILLEGAL HANDLER INDEX MEANS DEVICE NOT OPEN FOR OPERATION 

1098 

E643 

AO 

85 



LDY 


4N0TQPN 

; ERROR CODE 

1099 

1100 

E645 

BO 

IB 



BCS 


COM2 

RETURN 

1101 





USE 

HANDLER ADDRESS TABLE 

AND COMMAND TABLE TO GET VECTOR 

1102 

E647 

B9 

IB 

03 C0M1: 

LDA 


HATABS+1, Y 

GET LOW BYTE OF ADDRESS 

1103 

E64A 

85 

2C 



STA 


ICSPRZ 

AND SAVE IN POINTER 

1104 

E64C 

B9 

1C 

03 


LDA 


HATABS+2, Y 

GET HI BYTE OF ADDRESS 

1105 

E64F 

85 

2D 



STA 


ICSPRZ+1 


1106 

E651 

A4 

17 



LDY 


ICCOMT 

GET COMMAND CODE 

1107 

E653 

B9 

C6 

E6 


LDA 


COMTAB-3, Y 

GET COMMAND OFFSET 

1108 

E656 

A8 




TAY 




1109 

E657 

B1 

2C 



LDA 


( ICSPRZ), Y 

GET LOW BYTE OF VECTOR FROM 

1110 

E659 

AA 




TAX 



HANDLER ITSELF AND SAVE 

1111 

E65A 

C8 




INY 




1112 

E65B 

B1 

2C 



LDA 


( ICSPRZ), Y 

GET HI BYTE OF VECTOR 

1113 

E65D 

85 

2D 



STA 


ICSPRZ+1 


1114 

E65F 

86 

2C 



STX 


ICSPRZ 

SET LO BYTE 

1115 

E661 

18 




CLC 


; SHOW NO ERROR 

1116 

E662 

60 


COM2: 

RTS 




1117 

1118 










1119 





DECBFL — 

DECREMENT BUFFER 

LENGTH DOUBLE BYTE 

1120 





Z FLAG = C 

ON 

RETURN IF LENGTH = 0 AFTER DECREMENT 

1121 

E663 

C6 

28 

DECBFL 

: DEC 


ICBLLZ 

DECREMENT LOW BYTE 

1122 

E665 

A5 

28 



LDA 


ICBLLZ 

CHECK IT 

1123 

E667 

C9 

FF 



CMP 


#$FF 

DID IT GO BELOW? 

1124 

E669 

DO 

02 



BNE 


DECBF1 

NO 

1125 

E66B 

C6 

29 



DEC 


ICBLLZ+1 

DECREMENT HI BYTE 

1126 

E66D 

05 

29 

DECBF1 

ORA 


ICBLLZ+1 

SET Z IF BOTH ARE ZERO 

1127 

1128 
1129 

E66F 

60 




RTS 




1130 





INCBFP — 

INCREMENT WORKING BUFFER POINTER 

1131 

E670 

E6 

24 

INCBFP 

INC 


ICBALZ 

BUMP LOW BYTE 

1132 

E672 

DO 

02 



BNE 


INCBF1 

GO IF NOT ZERO 

1133 

E674 

E6 

25 



INC 


ICBALZ+ 1 

ELSE, BUMP HI BYTE 

1134 

E676 

60 


INCBF1 

RTS 




1135 

1 136 










1137 





SUBBFL — 

SET 

BUFFER LENGTH = BUFFER LENGTH - WORKING BYTE 

1 138 

E677 

A6 

2E 

SUBBFL 

LDX 


ICIDNO 

GET IOCB INDEX 

1 139 

E679 

38 




SEC 




1 140 

E67A 

BD 

48 

03 


LDA 


ICBLL, X ; 

GET LOW BYTE OF INITIAL LENGTH 


PAGE 


COUNT 



ERR LINE 

ADDR 

B1 

B2 

B3 B4 

CENTRAL INPUT/OUTPUT (CIO) 2-7-79 PAGE 27 

1141 

E67D 

E5 

28 


SBC 

ICBLLZ 

SUBTRACT FINAL LOW BYTE 

1142 

E67F 

85 

28 


STA 

ICBLLZ 

AND SAVE BACK 

1143 

E681 

BD 

49 

03 

LDA 

ICBLH# X 

GET HI BYTE 

1144 

E6S4 

E5 

29 


SBC 

ICBLLZ+1 


1145 

E686 

85 

29 


STA 

ICBLHZ 


1146 

E688 

60 



RTS 



1147 








1148 








1149 





; GOHAND — GO 

INDIRECT TO A 

DEVICE HANDLER 

1150 





i Y= STATUS ON 

RETURN/ N FLAG=1 IF ERROR ON RETURN 

1151 

E689 

AO 

92 


GOHAND: LDY 

#FNCNOT 

PREPARE NO FUNCTION STATUS FOR HANDLER RTS 

1152 

E68B 

20 

93 

>0 

U) 

JSR 

Cl JUMP 

USE THE INDIRECT JUMP 

1153 

E68E 

84 

23 


STY 

ICSTAZ 

SAVE STATUS 

1154 

E690 

CO 

00 


CPY 

#0 

AND SET N FLAG 

1155 

E692 

60 



RTS 



1156 





; 



1157 





; INDIRECT JUMP 

TO HANDLER BY PAUL'S METHOD 

1158 

E693 

AA 



Cl JUMP: TAX 


SAVE A 

1159 

E694 

A5 

2D 


LDA 

ICSPRZ+1 

GET JUMP ADDRESS HI BYTE 

1160 

E696 

48 



PHA 


PUT ON STACK 

1161 

E697 

A5 

2C 


LDA 

ICSPRZ 

GET JUMP ADDRESS LO BYTE 

1162 

E699 

48 



PHA 


PUT ON STACK 

1163 

E69A 

8A 



TXA 


RESTORE A 

1164 

E69B 

A6 

2E 


LDX 

ICIDNO 

GET IOCB INDEX 

1165 

E69D 

60 



RTS 


GO TO HANDLER INDIRECTLY 



ERR LINE 

ADDR 

B1 

B2 

B3 B4 

CENTRAL INPUT/OUTPUT (CIO) 

2-7-79 PAGE 

1166 






. PAGE 



1167 





i 




1168 





i DEVSRC 

— DEVICE SEARCH, FIND DEVICE IN HANDLER ADDRESS TABLE 

1169 





i 




1170 





i LOOP TO FIND 

DEVICE 


1171 

E69E 

AO 

00 


DEVSRC : 

LDY 

#0 


1172 

E6A0 

B 1 

24 



LDA 

( ICBALZ), Y 

GET DEVICE NAME FROM USER 

1173 

E6A2 

FO 

OC 



BEQ 

CIERR2 


1174 

E6A4 

AO 

21 



LDY 

#MAXDEV 

INITIAL COMPARE INDEX 

1175 

E6A6 

D9 

1A 

03 

DEVS1: 

CMP 

HATABS, Y 

IS THIS THE DEVICE? 

1176 

E6A9 

FO 

OA 



BEQ 

DEVS2 

YES 

1177 

E6AB 

88 




DEY 



1178 

E6AC 

88 




DEY 


ELSE, POINT TO NEXT DEVICE NAME 

1179 

E6AD 

88 




DEY 



1180 

E6AE 

10 

F6 



BPL 

DEVS1 

CONTINUE FOR ALL DEVICES 

1181 





i 




1182 





i NO DEVICE FOUND, DECLARE NON-EXISTENT DEVICE ERROR 

1183 

E6B0 

AO 

82 


CIERR2: 

LDY 

#NQNDEV 

ERROR CODE 

1184 

E6B2 

38 




SEC 


SHOW ERROR 

1185 

E6B3 

BO 

13 



BCS 

DEVS4 

AND RETURN 

1186 





i 




1187 





; FOUND 

DEVICE, 

SET ICHID, ICDNO, AND INIT DEVICE 

1188 

E6B5 

98 



DEVS2: 

TYA 



1189 

E6B6 

85 

20 



STA 

ICHIDZ 

SAVE HANDLER INDEX 

1190 

E6B8 

38 




SEC 



1191 

E6B9 

AO 

01 



LDY 

#1 


1192 

E6BB 

B1 

24 



LDA 

<ICBALZ>, Y 

GET DEVICE NUMBER (DRIVE NUMBER) 

1193 

E6BD 

E9 

30 



SBC 

#ASCZER 

SUBTRACT ASCII ZERO 

1194 

E6BF 

C9 

OA 



CMP 

#$A 

IS NUMBER IN RANGE? 

1195 

E6C 1 

90 

02 



BCC 

DEVS3 

YES 

1196 

E6C3 

A9 

01 



LDA 

#1 

NO, DEFAULT TO ONE 

1197 

E6C5 

85 

21 


DEVS3: 

STA 

ICDNOZ 

SAVE DEVICE NUMBER 

1198 

E6C7 

18 




CLC 


SHOW NO ERROR 

1199 





; 




1200 





i RETURN 



1201 

E6C8 

60 



DEVS4: 

RTS 




28 



ERR LINE ADDR B1 B2 B3 B4 


CENTRAL INPUT/OUTPUT (CIO) 2-7-79 


PAGE 29 


1202 . PAGE 

1203 

1204 ; 

1205 ; CIO ROM TABLES 

1206 ; 

1207 i COMMAND TABLE 

1208 i MAPS EACH COMMAND TO OFFSET FOR APPROPRIATE VECTOR IN HANDLER 


1209 

E6C9 

00 

04 

04 

04 

COMTAB: 

.BYTE 0,4,4,4,4,6,6/6,6,2,8,10 

1210 

E6CD 

04 

06 

06 

06 



1211 

E6D1 

06 

02 

08 

OA 



1212 

022F 





LENGTH 

=*-CIOINT 

1213 

E6D5 





CRNTP1 

=* 

1214 







*=$14 

1215 

0014 

00 




CIOSPR: 

.BYTE INT0RG-CRNTP1 i^GCIOL IS TOO LONG 



ERR LINE 

ADDR 

B1 

B2 

B3 

B4 

CENTRAL INPUT/OUTPUT (CIO) 


2-7-79 




PAGE 30 

1216 















1217 







. TITLE 

' INTERRUPT 

HANDLER ' 





1218 






; LIVES 

ON DK1: INTHV. SRC 







1219 

0006 





SRTIM2 

= 

6 


SECOND 

REPEAT 

INTERVAL 


1220 















1221 






; THIS 

IS TO MAKE DOS 2 WORK 

WHICH USED 

AN 

ABSOLUTE 

ADDRESS 

1222 















1223 







*=*E912 








1224 

E912 

4C 

ED 

E8 



JMP 

SETVBL 







1225 







*=SETVBV 







1226 

E45C 

4C 

ED 

E8 



JMP 

SETVBL 







1227 

E45F 

4C 

AE 

E7 



JMP 

SYSVBL 







1228 

E462 

4C 

05 

E9 



JMP 

XITVBL 







1229 







*=INTINV 







1230 

E46B 

4C 

D5 

E6 



JMP 

IHINIT 







1231 






# 









1232 







*=VCTABL+ INTABS-VDSLST 





1233 






# 









1234 

E480 

90 

E7 




. WORD 

SYRTI 


VDSLST 





1235 

E482 

8F 

E7 




. WORD 

SYIRQB 


VPRCED 





1236 

E484 

8F 

E7 




. WORD 

SYIRGB 


VINTER 





1237 

E486 

8F 

E7 




. WORD 

SYIRQB 


VBREAK 





1238 






/ 









1239 

E488 






. RES 

8 







1240 

E490 

8F 

E7 




. WORD 

SYIRQB 


VTIMR1 





1241 

E492 

8F 

E7 




. WORD 

SYIRQB 


VTIMR2 





1242 

E494 

8F 

E7 




. WORD 

SYIRQB 


VTIMR4 





1243 

E496 

06 

E7 




. WORD 

SYIRQ 


VIMIRG 





1244 

E498 

00 

00 

00 

00 


. WORD 

0/ 0, 0, 0, 0 


CDTMV1- 

-4 




1245 

E49C 

00 

00 

00 

00 










1246 

E4A0 

00 

00 












1247 

E4A2 

AE 

E7 




. WORD 

SYSVBL 


VVBLKI 





1248 

E4A4 

05 

E9 




. WORD 

XITVBL 


VVBLKD 





1249 






; 









1250 







*=*900C 








1251 






t 









1252 

900C 

A9 

E6 




LDA 

#P IRQH 


SET UP 

RAM 

VECTORS FOR 

LINBUG VERSION 

1253 

900E 

8D 

F9 

FF 



STA 

$FFF9 







1254 

9011 

A9 

F3 




LDA 

#P I RQL 







1255 

9013 

8D 

F8 

FF 



STA 

$FFF8 







1256 

9016 

A9 

E7 




LDA 

#PNMIH 







1257 

9018 

8D 

FB 

FF 



STA 

*FFFB 







1258 

90 IB 

A9 

91 




LDA 

#PNMIL 







1259 

901D 

8D 

FA 

FF 



STA 

*FFFA 







1260 

9020 

60 





RTS 










ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

INTERRUPT HANDLER 


PAGE 3 

1261 






. PAGE 




1262 










1263 





IRQ HANDLER 




1264 










1265 





JUMP 

THRU IMMEDIATE IRQ 

VECTOR, WHICH ORDINARILY POINTS TO 

1266 





SYSTEM IRQ: 

DETERMINE * 

CLEAR CAUSE, JUMP THRU SOFTWARE VECTOR. 

1267 










1268 






*=INTORG 



1269 

E6D5 

A9 

40 

IHINIT 

LDA 

#*40 


VBL ON BUF DLIST OFF***FOR NOW*** 

1270 

E6D7 

8D 

OE 

D4 


STA 

NMIEN 


ENABLE DISPLAY LIST, VERTICAL BLANK 

1271 

E6DA 

A9 

38 



LDA 

#*38 


LOOK AT DATA DIRECTION REGISTERS IN PIA 

1272 

E6DC 

8D 

02 

D3 


STA 

PACTL 



1273 

E6DF 

8D 

03 

D3 


STA 

PBCTL 



1274 

E6E2 

A9 

00 



LDA 

#0 


MAKE ALL INPUTS 

1275 

E6E4 

8D 

00 

D3 


STA 

PORTA 



1276 

E6E7 

8D 

01 

D3 


STA 

PORTB 



1277 

E6EA 

A9 

3C 



LDA 

#*3C 


BACK TO PORTS 

1278 

E6EC 

8D 

02 

D3 


STA 

PACTL 



1279 

E6EF 

8D 

03 

D3 


STA 

PBCTL 



1280 

E6F2 

60 




RTS 




1281 

E6F3 

6C 

16 

02 P IRQ: 

JMP 

< VIMIRQ ) 



1282 

E6F6 

80 


CMPTAB 

. BYTE 

*80 


BREAK KEY 

1283 

E6F7 

40 




. BYTE 

*40 


KEY STROKE 

1284 

E6F8 

04 




. BYTE 

*04 


TIMER 4 

1285 

E6F9 

02 




. BYTE 

*02 


TIMER 2 

1286 

E6FA 

01 




. BYTE 

*01 


TIMER 1 

1287 

E6FB 

08 




. BYTE 

*08 


SERIAL OUT COMPLETE 

1288 

E6FC 

10 




. BYTE 

*10 


SERIAL OUT READY 

1289 

E6FD 

20 




. BYTE 

*20 


SERIAL IN READY 

1290 

E6FE 









1291 





THIS 

IS A TABLE OF OFFSETS 

INTO PAGE 2. THEY POINT TO 

1292 

E6FE 

36 


ADRTAB 

. BYTE 

BRKKY-INTABS 


1293 

E6FF 

08 




. BYTE 

VKEYBD- INTABS 

1294 

E700 

14 




. BYTE 

VT I MR 4- INTABS 

1295 

E701 

12 




. BYTE 

VT I MR2- INTABS 

1296 

E702 

10 




. BYTE 

VT I MR 1- INTABS 

1297 

E703 

0E 




. BYTE 

VSEROC-INTABS 

1298 

E704 

OC 




. BYTE 

VSEROR- INTABS 

1299 

E705 

OA 




. BYTE 

VSER IN- INTABS 

1300 

E706 









1301 

E706 

48 


SYIRQ: 

PHA 


i SAVE ACCUMULATOR 

1302 

E707 

AD 

OE 

D2 


LDA 

IRQST 


CHECK FOR SERIAL IN 

1303 

E70A 

29 

20 



AND 

#*20 



1304 

E70C 

DO 

OD 



BNE 

SYIRQ2 



1305 

E70E 

A9 

DF 



LDA 

#*DF 


MASK ALL OTHERS 

1306 

E710 

8D 

OE 

D2 


STA 

IRQEN 



1307 

E713 

A5 

10 



LDA 

POKMSK 



1308 

E715 

8D 

OE 

D2 


STA 

IRQEN 



1309 

E718 

6C 

OA 

02 


JMP 

(VSER IN) 



1310 

E71B 

8A 


SYIRQ2 

TXA 



PUT X INTO ACC 

1311 

E71C 

48 




PHA 



SAVE X ONTO STACK 

1312 

E71D 

A2 

06 



LDX 

#*6 


START WITH SIX OFFSET 

1313 

E71F 

BD 

F6 

E6 LOOPM: 

LDA 

CMPTAB, X 


LOAD MASK 

1314 

E722 

EO 

05 



CPX 

#5 


CHECK TO SEE IF COMPLETE IS SET 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 ' 

INTERRUPT HANDLER 

1315 

E724 

DO 

04 



BNE 

L00PM2 

1316 

E726 

25 

10 



AND 

POKMSK 

1317 

E728 

FO 

05 



BEG 

LL 

1318 

E72A 

2C 

OE 

D2 

LOOP M2: 

BIT 

IRGST 

1319 

E72D 

FO 

06 



BEG 

JMPP 

1320 

E72F 

CA 



LL: 

DEX 


1321 

E730 

10 

ED 



BPL 

LOOPM 

1322 

E732 

4C 

62 

E7 


JMP 

SYIRG8 

1323 

E735 

49 

FF 


JMPR: 

EOR 

#$FF 

1324 

E737 

8D 

OE 

D2 


STA 

IRGEN 

1325 

E73A 

A5 

10 



LDA 

POKMSK 

1326 

E73C 

8D 

OE 

D2 


STA 

IRGEN 

1327 

E73F 

BD 

FE 

E6 


LDA 

ADR TAB, X 

1328 

E742 

AA 




TAX 


1329 

E743 

BD 

00 

02 


LDA 

INTABS, X 

1330 

E746 

8D 

8C 

02 


STA 

JVECK 

1331 

E749 

BD 

01 

02 


LDA 

INTABS+1 

1332 

E74C 

8D 

8D 

02 


STA 

JVECK+1 

1333 

E74F 

68 




PLA 


1334 

E750 

AA 




TAX 


1335 

E751 

6C 

8C 

02 


JMP 

(JVECK) 

1336 

E754 

A9 

00 


BRKKY2: 

LDA 

#0 

1337 

E756 

85 

11 



STA 

BRKKEY 

1338 

E758 

8D 

FF 

02 


STA 

SSFLAG 

1339 

E75B 

8D 

FO 

02 


STA 

CRSINH 

1340 

E75E 

85 

4D 



STA 

ATRACT 

1341 

E760 

68 




PLA 


1342 

E761 

40 




RTI 


1343 

E762 

68 



SYIRG8: 

PLA 


1344 

E763 

AA 




TAX 


1345 

E764 

2C 

02 

D3 


BIT 

PACTL 

1346 

E767 

10 

06 



BPL 

SYIRQ9 

1347 

E769 

AD 

00 

D3 


LDA 

PORTA 

1348 

E76C 

6C 

02 

02 


JMP 

(VPRCED) 

1349 

E76F 

2C 

03 

D3 

SYIRG9: 

BIT 

PBCTL 

1350 

E772 

10 

06 



BPL 

SYIRQA 

1351 

E774 

AD 

01 

D3 


LDA 

PORTB 

1352 

E777 

6C 

04 

02 


JMP 

(VINTER) 

1353 

E77A 

68 



SYIRQA: 

PLA 


1354 

E77B 

8D 

8C 

02 


STA 

JVECK 

1355 

E77E 

68 




PLA 


1356 

E77F 

48 




PHA 


1357 

E780 

29 

10 



AND 

#$10 

1358 

E782 

FO 

07 



BEG 

SYRTI2 

1359 

E784 

AD 

8C 

02 


LDA 

JVECK 

1360 

E787 

48 




PHA 


1361 

E788 

6C 

06 

02 


JMP 

( VBREAK ) 

1362 

E78B 

AD 

8C 

02 

SYRTI2: 

LDA 

JVECK 

1363 

E78E 

48 




PHA 


1364 

E78F 

68 



SYIRGB: 

PLA 


1365 

E790 

40 



SYRTI: 

RTI 



PAGE 32 


; IS THIS INTERUPT ENABLED? 

; IS IT THE INTERUPT? 

; NO DEC X AND TRY NEXT MASK 
; IF NOT NEG GOTO LOOPM 
; DONE BUT NO INTERUPT 
; COMPLEMENT MASK 
; ENABLE ALL OTHERS 
; GET POKE MASK 
; ENABLE THOSE IN POKE MASK 


; GET ADDRESS LOW PART 
; PUT IN VECTOR 
X ; GET ADDRESS HIGH PART 
; PUT IN VECTOR HIGH PART 
; PULL X REGISTER FROM STACK 
; PUT IT INTO X 
; JUMP TO THE PROPER ROUTINE 
; BREAK KEY ROUTINE 
; SET BREAK KEY FLAG 
; START/STOP FLAG 
; CURSOR INHIBIT 
; TURN OFF ATRACT MODE 

; EXIT FROM I NT 


; PROCEED ***I GUESS*** 
CLEAR INT STATUS BIT 
; INTERRUPT ***I GUESS*** 
; CLEAR INT STATUS 


;B BIT OF P REGISTER 


; UNIDENTIFIED INTERRUPT, JUST RETURN. 



ERR LINE ADDR B1 B2 B3 B4 


INTERRUPT HANDLER 


PAGE 


33 


1366 . PAGE 

1367 ; 

1368 ; NMI HANDLER 

1369 

1370 ; DETERMINE CAUSE AND JUMP THRU VECTOR 

1371 ; 


1372 

E791 

2C 

OF 

D4 

PNMI: 

BIT 

NMI ST 


1373 

E794 

10 

03 



BPL 

PNMI 1 

; SEE IF DISPLAY LIST 

1374 

E796 

6C 

00 

02 


JMP 

(VDSLST) 


1375 

E799 

48 



PNMI1: 

PHA 



1376 

E79A 

AD 

OF 

D4 


LDA 

NMI ST 


1377 

E79D 

29 

20 



AND 

#$20 

i SEE IF RESET 

1378 

E79F 

FO 

03 



BEQ 



1379 

E7A1 

4C 

74 

E4 


JMP 

WARMSV 

; GO THRU WARM START JUMP 

1380 

E7A4 

8A 




TXA 


i SAVE REGISTERS 

1381 

E7A5 

48 




PHA 



1382 

E7A6 

98 




TYA 



1383 

E7A7 

48 




PHA 



1384 

E7A8 

8D 

OF 

D4 


STA 

NMI RES 

; RESET INTERRUPT STATUS 

1385 

E7AB 

6C 

22 

02 


JMP 

< VVBLKI ) 

; JUMP THRU VECTOR 



ERR LINE ADDR B1 B2 B3 B4 


INTERRUPT HANDLER 


PAGE 34 


1386 

1387 

1388 

1389 

1390 

1391 

1392 

1393 

E7AE 

E6 

14 


1394 

E7B0 

DO 

08 


1395 

E7B2 

E6 

4D 


1396 

E7B4 

E6 

13 


1397 

E7B6 

DO 

02 


1398 

E7B8 

E6 

12 


1399 

E7BA 

A9 

FE 


1400 

E7BC 

A2 

00 


1401 

E7BE 

A4 

4D 


1402 

E7C0 

10 

06 


1403 

E7C2 

85 

4D 


1404 

E7C4 

A6 

13 


1405 

E7C6 

A9 

F6 


1406 

E7C8 

85 

4E 


1407 

E7CA 

86 

4F 


1408 

E7CC 

A2 

00 


1409 

E7CE 

20 

DO 

E8 

1410 

E7D1 

DO 

03 


1411 

E7D3 

20 

CA 

ES 

1412 

E7D6 

A5 

42 


1413 

E7D8 

DO 

08 


1414 

E7DA 

BA 



1415 

E7DB 

BD 

04 

01 

1416 

E7DE 

29 

04 


1417 

E7E0 

FO 

03 


1418 

E7E2 

4C 

05 

E9 

1419 

E7E5 

AD 

OD 

D4 

1420 

E7E8 

8D 

35 

02 

1421 

E7EB 

AD 

OC 

D4 

1422 

E7EE 

8D 

34 

02 

1423 

E7F1 

AD 

31 

02 

1424 

E7F4 

8D 

03 

D4 

1425 

E7F7 

AD 

30 

02 

1426 

E7FA 

8D 

02 

D4 

1427 

E7FD 

AD 

2F 

02 

1428 

E800 

8D 

00 

D4 

1429 

E803 

AD 

6F 

02 

1430 

E806 

8D 

IB 

DO 

1431 

E809 

A2 

08 


1432 

E80B 

8E 

IF 

DO 

1433 

E80E 

58 



1434 

E80F 

BD 

CO 

02 

1435 

E812 

45 

4F 


1436 

E814 

25 

4E 


1437 

E816 

9D 

12 

DO 

1438 

E819 

CA 



1439 

E81 A 

10 

F2 



. PAGE 

; SYSTEM VBLANK ROUTINE 

; INC FRAME COUNTER. PROCESS COUNTDOWN TIMERS. EXIT IF I WAS SET, CLEAR 
; SET DLISTL, DLISTH, DMACTL FROM RAM CELLS. DO SOFTWARE REPEAT. 

SYSVBL: INC RTCLOK+2 ; INC FRAME COUNTER 

BNE SYSVB1 

INC ATRACT ; INCREMENT ATRACT (CAUSES ATRACT WHEN MINUS) 

INC RTCLOK+1 

BNE SYSVB1 

INC RTCLQK 

SYSVB1: LDA #$FE ; {ATRACT! SET DARK MASK TO NORMAL 

LDX #0 ; SET COLRSH TO NORMAL 

LDY ATRACT ; TEST ATRACT FOR NEGATIVE 

BPL VBATRA ; WHILE POSITIVE, DONT GO INTO ATRACT 

STA ATRACT i IN ATRACT, SO STAY BY STA $FE 

LDX RTCLOK+1 ; COLOR SHIFT FOLLOWS RTCLOK+1 

LDA #$F6 ; SET DARK MASK TO DARK 

VBATRA: STA DRKMSK 

STX COLRSH 

LDX #0 ; POINT TO TIMER1 

JSR DC T I MR ; GO DECREMENT TIMER 1 

BNE SYSVB2 ; BRANCH IF STILL COUNTING 

JSR JTIMR1 ; GO JUMP TO ROUTINE 

SYSVB2: LDA CRITIC 

BNE XXIT ; GO IF CRITICAL SET 

TSX ; SEE IF I WAS SET 

LDA $104, X ; GET STACKED P 

AND #$04 i I BIT 

BEG SYSVB3 ; BRANCH IF OK 

XXIT: JMP XITVBL ; I WAS SET, EXIT 

SYSVB3: LDA PENV 

STA LPENV 

LDA PENH 

STA LPENH 

LDA SDLSTH 

STA DLISTH 

LDA SDLSTL 

STA DLISTL 

LDA SDMCTL 

STA DMACTL 

LDA GPRIOR ; GLOBAL PRIOR 

STA PRIOR 

LDX #$08 i TURN OFF KEYBOARD SPEAKER 

STX CONSOL 

SCOLLP : CLI ; DISABLE INTERUPTS 

LDA PCOLRO, X ; LOAD COLOR REGISTERS FROM RAM 

EOR COLRSH ; DO COLOR SHIFT 

AND DRKMSK ; AND DARK ATRACT 

STA COLPMO, X 

DEX 
BPL 


SCOLLP 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

INTERRUPT HANDLER 


1440 

E81C 

AD 

F4 

02 


LDA 

CHBAS 


1441 

E81F 

8D 

09 

D4 


STA 

CHBASE 


1442 

E822 

AD 

F3 

02 


LDA 

CHACT 


1443 

E825 

8D 

01 

D4 


STA 

CHACTL 


1444 

E828 

A2 

02 



LDX 

#2 

POINT TO TIMER 2 

1445 

E82A 

20 

DO 

E8 


JSR 

DC T I MR 


1446 

E82D 

DO 

03 



BNE 

SYSVB4 

IF DIDNT GO ZERO 

1447 

E82F 

20 

CD 

E8 


JSR 

JTIMR2 

GO JUMP TO TIMER2 ROUTINE 

1448 

E832 

A2 

02 


SYSVB4: 

LDX 

#2 

RESTORE X 

1449 

E834 

E8 



SYSVBB: 

INX 



1450 

E835 

E8 




INX 



1451 

E836 

BD 

18 

02 


LDA 

CDTMV1 » X 


1452 

E839 

ID 

19 

02 


ORA 

CDTMV1+1 , X 


1453 

E83C 

FO 

06 



BEG 

SYSVBA 


1454 

E83E 

20 

DO 

E8 


JSR 

DC T I MR 

DECREMENT AND SET FLAG IF NONZERO 

1455 

E841 

9D 

26 

02 


STA 

CDTMF3-4, X 


1456 

E844 

EO 

08 


SYSVBA: 

CPX 

#8 

SEE IF DONE ALL 3 

1457 

E846 

DO 

EC 



BNE 

SYSVBB 

LOOP 

1458 





; CHECK 

DEBOUNCE COUNTER 


1459 

E848 

AD 

OF 

D2 


LDA 

SKSTAT 


1460 

E84B 

29 

04 



AND 

#$04 

KEY DOWN BIT 

1461 

E84D 

FO 

08 



BEG 

SYVB6A 

IF KEY DOWN 

1462 





i KEY UP SO 

COUNT IT 


1463 

E84F 

AD 

FI 

02 


LDA 

KEYDEL 

KEY DELAY COUNTER 

1464 

E852 

FO 

03 



BEG 

SYVB6A 

IF COUNTED DOWN ALREADY 

1465 

E854 

CE 

FI 

02 


DEC 

KEYDEL 

COUNT IT 

1466 





/ CHECK 

SOFTWARE REPEAT TIMEI 

R 

1467 

E857 

AD 

2B 

02 

SYVB6A: 

LDA 

SRTIMR 


1468 

E85A 

FO 

17 



BEG 

SYSVB7 

DOESN'T COUNT 

1469 

E85C 

AD 

OF 

D2 


LDA 

SKSTAT 


1470 

E85F 

29 

04 



AND 

#$04 

CHECK KEY DOWN BIT 

1471 

E861 

DO 

60 



BNE 

SYSVB6 

BRANCH IF NO LONGER DOWN 

1472 

E863 

CE 

2B 

02 


DEC 

SRTIMR 

COUNT FRAME OF KEY DOWN 

1473 

E866 

DO 

OB 



BNE 

SYSVB7 

BRANCH IF NOT RUN OUT 

1474 





i TIMER 

RAN 

OUT - RESET AND 

SIMULATE KEYBOARD IRQ 

1475 

E868 

A9 

06 



LDA 

#SRTIM2 

TIMER VALUE 

1476 

E86A 

8D 

2B 

02 


STA 

SRTIMR 

SET TIMER 

1477 

E86D 

AD 

09 

D2 


LDA 

KBCODE 

GET THE KEY 

1478 

E870 

8D 

FC 

02 


STA 

CH 

PUT INTO CH 

1479 





i READ GAME 

CONTROLLERS 


1480 

E873 

AO 

01 


SYSVB7: 

LDY 

#1 


1481 

E875 

A2 

03 



LDX 

#3 


1482 

E877 

B9 

00 

D3 

STLOOP : 

LDA 

PORTA, Y 


1483 

E87A 

4A 




LSR 

A 


1484 

E87B 

4A 




LSR 

A 


1485 

E87C 

4A 




LSR 

A 


1486 

E87D 

4A 




LSR 

A 


1487 

E87E 

9D 

78 

02 


STA 

STICKO, X 

STORE JOYSTICK 

1488 

E881 

CA 




DEX 



1489 

E882 

B9 

00 

D3 


LDA 

PORTA, Y 


1490 

E885 

29 

OF 



AND 

#$F 


1491 

E887 

9D 

78 

02 


STA 

STICKO, X 

STORE JOYSTICK 

1492 

E88A 

CA 




DEX 



1493 

E88B 

88 




DEY 





ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

INTERRUPT HANDLER 

1494 

E88C 

10 

E9 



BPL 

STLOOP 

1495 





; 



1496 

E8SE 

A2 

03 



LDX 

#3 

1497 

E890 

BD 

10 

DO 

STRL: 

LDA 

TRIGG, X ; MOVE JOYSTICK TRIGGERS 

1498 

E893 

9D 

84 

02 


STA 

STRIGQ, X 

1499 

E896 

BD 

00 

D2 


LDA 

POTO, X ; MOVE POT VALUES 

1500 

E899 

9D 

70 

02 


STA 

PADDLO/ X 

1501 

E89C 

BD 

04 

D2 


LDA 

PQT4, X 

1502 

E89F 

9D 

74 

02 


STA 

PADDL4, X 

1503 

E8A2 

CA 




DEX 


1504 

E8A3 

10 

EB 



BPL 

STRL 

1505 

E8A5 

8D 

OB 

D2 


STA 

POTGO ; START POTS FOR NEXT TIME 

1506 





i 



1507 

E8A8 

A2 

06 



LDX 

#6 

1508 

E8AA 

AO 

03 



LDY 

#3 

1509 

E8AC 

B9 

78 

02 

PTRLP: 

LDA 

STICKQ, Y ; TRANSFER BITS FROM JOYSTICKS 

1510 

E8AF 

4A 




LSR 

A ; TO PADDLE TRIGGERS 

1511 

E8B0 

4A 




LSR 

A 

1512 

E8B 1 

4A 




LSR 

A 

1513 

E8B2 

9D 

7D 

02 


STA 

PTRIG1, X 

1514 

E8B5 

A9 

00 



LDA 

#0 

1515 

E8B7 

2A 




ROL 

A 

1516 

E8B8 

9D 

7C 

02 


STA 

PTRIGO, X 

1517 

E8BB 

CA 




DEX 


1518 

E8BC 

CA 




DEX 


1519 

E8BD 

88 




DEY 


1520 

E8BE 

10 

EC 



BPL 

PTRLP 

1521 





; 



1522 

E8C0 

6C 

24 

02 


JMP 

( VVBLKD ) i GO TO DEFERRED VBLANK ROUTINE 

1523 

00E8 




SV7H 

= 

SYSVB7/256 

1524 

0073 




SV7L 

= 

( -256 ) *SV7H+SYSVB7 

1525 

E8C3 

A9 

00 


SYSVB6: 

LDA 

#0 

1526 

E8C5 

8D 

2B 

02 


STA 

SRTIMR ; ZERO TIMER 

1527 

E8C8 

FO 

A9 



BEQ 

SYSVB7 ; UNCOND 

1528 

E8CA 

6C 

26 

02 

JTIMRlr 

JMP 

(CDTMA1 ) 

1529 

E8CD 

6C 

28 

02 

JTIMR2: 

JMP 

< CDTMA2 > 

1530 





i 



1531 





; SUBROUTINE TO 

DECREMENT A COUNTDOWN TIMER 

1532 





; ENTRY 

X=QFFSET FROM TIMER 1 

1533 





i EXIT 

A, P=ZERQ 

IF WENT ZERO, FF OTHERWISE 

1534 








1535 

E8D0 

BC 

18 

02 

DC T I MR: 

LDY 

CDTMV1 , X ; LO BYTE 

1536 

E8D3 

DO 

08 



BNE 

DC T I Ml i NONZERO, GO DEC IT 

1537 

E8D5 

BC 

19 

02 


LDY 

CDTMV1 + 1, X ; SEE IF BOTH ZERO 

1538 

E8D8 

FO 

10 



BEQ 

DCTXF ; YES, EXIT NONZERO 

1539 

EBDA 

DE 

19 

02 


DEC 

CDTMV1 + 1 , X } DEC HI BYTE 

1540 

E8DD 

DE 

18 

02 

DCTIM1 : 

DEC 

CDTMV1 , X ; DEC LO BYTE 

1541 

E8E0 

DO 

08 



BNE 

DCTXF 

1542 

E8E2 

BC 

19 

02 


LDY 

CDTMV1+1, X 

1543 

E8E5 

DO 

03 



BNE 

DCTXF 

1544 

E8E7 

A9 

00 



LDA 

#0 i WENT ZERO, RETURN ZERO 

1545 

E8E9 

60 




RTS 


1546 

E8EA 

A9 

FF 


DCTXF : 

LDA 

#*FF ; RETURN NONZERO 

1547 

E8EC 

60 




RTS 




ERR LINE 

ADDR 

B 1 B2 B3 B4 

INTERRUPT HANDLER 


1548 





. PAGE 



1549 








1550 




SUBROUTINE TO 

SET VERTICAL BLANK VECTORS AND TIMERS 

1551 




ENTRY 

X=H I / Y= 

LO BYTE TO 

SET 

1552 





A= 1-5 

TIMERS 1-5 


1553 





6 I MM VBLANK 


1554 





7 DEF VBLANK 


1555 








1556 

E8ED 

0A 

SETVBL: 

ASL 

A 

; MUL BY 2 

1557 

E8EE 

8D 2D 02 



STA 

INTEMP 


1558 

E8F 1 

8A 



TXA 



1559 

E8F2 

A2 05 



LDX 

#5 


1560 

E8F4 

8D OA D4 



STA 

WSYNC 

; WASTE 20 CPU CYCLES 

1561 

E8F7 

CA 

SETLOP: 

DEX 


; TO ALOWD VBLANK TO HAPPEN 

1562 

E8F8 

DO FD 



BNE 

SETLOP 

; IF THIS IS LINE "TC" 

1563 

E8FA 

AE 2D 02 



LDX 

INTEMP 


1564 

E8FD 

9D 17 02 



STA 

CDTMV1-1, X 


1565 

E900 

98 



TYA 



1566 

E901 

9D 16 02 



STA 

CDTMV1-2, X 


1567 

E904 

60 



RTS 



1568 








1569 




EXIT 

FROM VERTICAL BLANK 


1570 








1571 

E905 

68 

XITVBL: 

PLA 


; UNSTACK Y 

1572 

E906 

A8 



TAY 



1573 

E907 

68 



PLA 


; UNSTACK X 

1574 

E908 

AA 



TAX 



1575 

E909 

68 



PLA 


; UNSTACK A 

1576 

E90A 

40 



RTI 


i AND GO BACK FROM WHENCE. 

1577 

00E6 


PIRQH 

= 

P IRQ/256 


1578 

00F3 


PIRQL 

= 

<-256>*PIRGH+PIRG 

1579 

O0E7 


PNMIH 

— 

PNM 1/256 


1580 

0091 


PNMIL 

= 

( -256 ) *PNM I H+PNM I 

1581 




SPARE 

BYTE OR 

MODULE TOO 

LONG FLAG 

1582 

E90B 


CRNTP2 

=* 



1583 





*=$14 



1584 

0014 

39 

XNTSPR : 

. BYTE 

SI00RG-CRNTP2 ; ''GINTHV IS TOO LONG 


PAGE 



ERR LINE ADDR B1 B2 B3 B4 


INTERRUPT HANDLER 
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1585 

1586 

1587 

1588 

1589 

1590 

1591 

1592 

1593 

1594 

1595 

1596 

1597 

1598 

1599 

1600 
1601 
1602 
1603 


. TITLE 'SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER > ' 
COLLEEN OPERATING SYSTEM 

SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) 

WITH SOFTWARE BAUD RATE CORRECTION ON CASSETTE 


AL MILLER 3- APR-79 


THIS MODULE HAS ONE ENTRY POINT. IT IS CALLED BY THE DEVICE 
HANDLERS. IT INTERPRETS A PREVIOUSLY ESTABLISHED DEVICE CONTROL 
BLOCK (STORED IN GLOBAL RAM) TO ISSUE COMMANDS 
TO THE SERIAL BUS TO CONTROL TRANSMITTING AND RECEIVING DATA. 



ERR LINE ADDR B1 B2 B3 B4 


SIO < SERIAL BUS INPUT/OUTPUT CONTROLLER ) 


PAGE 39 


1604 . PAGE 

1605 ; EQUATES 

1606 ; 

1607 ; DCD DEVICE BUS ID NUMBERS 


1608 

1609 

1610 

0030 

FLOPPY = 

} PRINTR = 
iCASSET = 


$30 

$40 

$60 

1611 

1612 

1613 

1614 

1615 

0060 

CASET 

i 

; BUS COMMANDS 

i 

$60 

1616 

0052 

READ 


'R 

1617 

1618 

1619 

1620 
1621 

0057 

WRITE 
iSTATIS = 

; FORMAT = 

i 

i 

'S 

/ i 

'W 

1622 


i COMMAND 

AUX 

BYTES 


1623 


! ! ! ! ! ***** 
! ! ! ! * ***** 


1624 

0053 

SIDWAY * 

1625 

004E 

NORMAL • 

1626 

0044 

DOUBLE = 

1627 

0050 

PLOT 

1628 


# 

1629 



1630 


i BUS RESPONSES 

1631 


# 


'S ; PRINT 16 CHARACTERS SIDEWAYS 

'N f PRINT 40 CHARACTERS NORMALLY 

'D ; PRINT 20 CHARACTERS DOUBLE WIDE 

'P i PLOT MODE 


1632 

0041 

ACK 

= 

'A 

DEVICE ACKNOWLEDGES INFORMATION 

1633 

004E 

NACK 

= 

'N 

DEVICE DID NOT UNDERSTAND 

1634 

0043 

COMPLT 

= 

'C 

DEVICE SUCCESSFULLY COMPLETED OPERATION 

1635 

0045 

ERROR 

as 

'E 

DEVICE INCURRED AN ERROR IN AN ATTEMPTED OP 

1636 


; 




1637 


# 




1638 


; MISCELLANEOUS 

EQUATES 


1639 


/ 




1640 

0028 

B192L0 

as 

$28 

19200 BAUD RATE POKEY COUNTER VALUES (LO BY 

1641 

0000 

B192HI 

= 

$00 

(HI BYTE) 

1642 

OOCC 

B600L0 

as 

$CC 

600 BAUD (LO BYTE) 

1643 

0005 

B600HI 

= 

$05 

(HI BYTE) 

1644 

0005 

HI TONE 

as 

$05 

FSK HI FREQ POKEY COUNTE VALUE (5326 HZ) 

1645 

0007 

LOTONE 

= 

$07 

FSK LO FREQ POKEY COUNTER VALUE (3995 HZ) 

1646 


i 




1647 



. IF 

PALFLG 


1648 


WIRGLO 

as 

150 

WRITE INTER RECORD GAP (IN 1/60 SEC) 

1649 


RIRGLO 

- 

100 

READ INTER RECORD GAP (IN 1/60 SEC) 

1650 


WSIRG 

- 

13 

SHORT WRITE INTER RECORD GAP 

1651 


RSIRG 

a= 

8 

SHORT READ INTER RECORD GAP 

1652 



. END IF 



1653 



. IF 

PALFLG- 1 


1654 

00B4 

WIRGLO 

= 

180 

WRITE INTER RECORD GAP (IN 1/60 SEC) 

1655 

0078 

RIRGLO 

as 

120 

READ INTER RECORD GAP (IN 1/60 SEC) 

1656 

OOOF 

WSIRG 

as 

15 

SHORT WRITE INTER RECORD GAP 

1657 

OOOA 

RSIRG 

as 

10 

SHORT READ INTER RECORD GAP 



ERR LINE 

ADDR B 1 B2 B3 B4 

SIO ( SERIAL 

BUS INPUT/OUTPUT CONTROLLER ) PAGE 

1658 



. END IF 



1659 

0000 

WIRGHI 

= 

0 


1660 

1661 

0000 

RIRGHI 

= 

0 


1662 

0034 

NCQMLO 

= 

$34 

PI A COMMAND TO LOWER NOT COMMAND LINE 

1663 

003C 

NCOMHI 

= 

$3C 

PIA COMMAND TO RAISE NOT COMMAND LINE 

1664 

0034 

MOTRGO 

= 

$34 

P I A COMMAND TO TURN ON CASSETTE MOTOR 

1665 

003C 

MOTRST 

= 

$3C 

PIA COMMAND TO TURN OFF MOTOR 

1666 

1667 

0002 

TEMPHI 

_ 

TEMP/256 

ADDRESS OF TEMP CELL (HI BYTE) 

1668 

003E 

TEMPLO 

= 

( -256 ) *TEMPH I +TEMP ; (LO BYTE) 

1669 

0002 

CBUFHI 

= 

CDEVIC/256 

ADDRESS OF COMMAND BUFFER (HI BYTE) 

1670 

003A 

CBUFLO 

ss 

< -256 ) -&CBUFHI+CDEVIC ; (LO BYTE) 

1671 

1672 

000D 

i 

CRETRI 

_ 

13 

NUMBER OF COMMAND FRAME RETRIES 

1673 

0001 

DRETRI 

= 

1 

NUMBER OF DEVICE RETRIES 

1674 

0002 

CTIMLQ 

= 

2 

COMMAND FRAME ACK TIME OUT (LO BYTE) 

1675 

0000 

CTIMHI 

as 

0 

COMMAND FRAME ACK TIME OUT (HI BYTE) 

1676 

1677 

1678 


; JTADRH 


JTIMER/256 

; HI BYTE OF JUMP TIMER ROUTINE ADDR 

1679 


; JTADRL 

= 

< -256 ) * JT ADRH+ JT I MER ; "MOVED TO LINE 1428" 

1680 








ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

SIO ( SERIAL 

BUS INPUT/OUTPUT CONTROLLER ) 

PAGE 

1681 





. PAGE 




1682 





SIO 




1683 

1684 

1685 





*=SIOV 




1686 

1687 

E459 

4C 

59 

E9 

JMP 

SIO 

; SIO ENTRY POINT 


1688 





*=SIOINV 



1689 

E465 

4C 

44 

E9 

JMP 

SIO I NT 

; SIO INITIALIZATION ENTRY POINT 

1690 









1691 





*=SENDEV 



1692 

1693 

E468 

4C 

F2 

EB 

JMP 

SENDEN 

» SEND ENABLE ENTRY POINT 


1694 





*=VCTABL-INTABS+VSERIN 


1695 

1696 

E48A 

OF 

EB 


. WORD 

ISRSIR 

; USER IN 


1697 

E48C 

90 

EA 


. WORD 

ISRODN 

; VSEROR 


1698 

1699 

1700 

1701 

E48E 

CF 

EA 


. WORD 

ISRTD 

; VSEROC 


1702 





*=SIOORG 



1703 









1704 





SIO INITIALIZATION SUBROUTINE 


1705 









1706 

E944 

A9 

3C 

SIQINT : LDA 

#MQTRST 



1707 

E946 

8D 

02 

D3 

STA 

PACTL 

; TURN OFF MOTOR 


1708 

1709 

E949 

A9 

3C 


LDA 

#NCOMHI 



1710 

1711 

1712 

E94B 

8D 

03 

D3 

STA 

PBCTL 

; RAISE NOT COMMAND LINE 


1713 

E94E 

A9 

03 


LDA 

#3 



1714 

E950 

8D 

32 

02 

STA 

SSKCTL 

i GET POKEY OUT OF INITIALIZE 

MODE 

1715 

E953 

85 

41 


STA 

SOUNDR 

; INIT POKE ADDRESS FOR QUIET 

I/O 

1716 

E955 

8D 

OF 

D2 

STA 

SKCTL 



1717 

1718 

1719 

1720 

1721 

1722 

1723 

1724 

1725 

E958 

60 



RTS 


; RETURN 


1726 

E959 

BA 


SIO: TSX 




1727 

E95A 

8E 

18 

03 

STX 

STACKP 

; SAVE STACK POINTER 


1728 

E95D 

A9 

01 


LDA 

#1 



1729 

1730 

E95F 

85 

42 


STA 

CRITIC 



1731 

E961 

AD 

00 

03 

LDA 

DDEVIC 



1732 

E964 

C9 

60 


CMP 

#CASET 



1733 

E966 

DO 

03 


BNE 

NOTCST 

; BRANCH IF NOT CASSETTE 


1734 

E968 

4C 

80 

EB 

JMP 

CASENT 

i OTHERWISE JUMP TO CASSETTE ENTER 


41 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

SIO < SERIAL 

BUS INPUT /OUTPUT CONTROLLER > PAGE 

42 

1735 









1736 





ALL DEVICES 

EXCEPT CASSETTE ARE INTELLIGENT 


1737 









1738 

E96B 

A9 

00 

NOTCST : LDA 

#0 



1739 

E96D 

8D 

OF 

03 

STA 

CASFLG 

; INIT CASSETTE FLAG TO NO CASSETTE 


1740 









1741 

E970 

A9 

01 


LDA 

#DRETR I 

; SET NUMBER OF DEVICE RETRIES 


1742 

E972 

85 

37 


STA 

DRETRY 



1743 

E974 

A9 

OD 

COMMND: LDA 

#CRETR I 

; SET NUMBER OF COMMAND FRAME RETRIES 


1744 

E976 

85 

36 


STA 

CRETRY 



1745 









1746 





SEND A COMMAND FRAME 



1747 









1748 

E978 

A9 

28 

COMFRM: LDA 

#B 192L0 

; SET BAUD RATE TO 19200 


1749 

E97A 

8D 

04 

D2 

STA 

AUDF3 



1750 

E97D 

A9 

00 


LDA 

#B192HI 



1751 

E97F 

8D 

06 

D2 

STA 

AUDF4 



1752 









1753 

E982 

18 



CLC 


> SET UP COMMAND BUFFER 


1754 

E983 

AD 

00 

03 

LDA 

DDEVIC 



1755 

E986 

6D 

01 

03 

ADC 

DUN IT 



1756 

E989 

69 

FF 


ADC 

#$FF 

; SUBTRACT 1 


1757 

E98B 

8D 

3A 

02 

STA 

CDEVIC 

; SET BUS ID NUMBER 


1758 





• 




1759 

E98E 

AD 

02 

03 

LDA 

DCOMND 



1760 

E991 

8D 

3B 

02 

STA 

CCOMND 

; SET BUS COMMAND 


1761 









1762 

E994 

AD 

OA 

03 

LDA 

DAUX1 

; STORE COMMAND FRAME AUX BYTES 1 AND 

2 

1763 

E997 

8D 

3C 

02 

STA 

CAUXi 



1764 

E99A 

AD 

OB 

03 

LDA 

DAUX2 



1765 

E99D 

8D 

3D 

02 

STA 

CAUX2 

; DONE SETTING UP COMMAND BUFFER 


1766 









1767 

E9A0 

18 



CLC 


; SET BUFFER POINTER TO COMMAND FRAME 

BUFFER 

1768 

E9A1 

A9 

3A 


LDA 

#CBUFLO 



1769 

E9A3 

85 

32 


STA 

BUFRLO 

; AND BUFFER END ADDRESS 


1770 

E9A5 

69 

04 


ADC 

#4 



1771 

E9A7 

85 

34 


STA 

BFENLO 



1772 

E9A9 

A9 

02 


LDA 

#CBUFHI 



1773 

E9AB 

85 

33 


STA 

BUFRHI 



1774 

E9AD 

85 

35 


STA 

BFENHI 

; DONE SETTING UP BUFFER POINTER 


1775 









1776 

E9AF 

A9 

34 


LDA 

#NCOMLO 

; LOWER NOT COMMAND LINE 


1777 

E9B 1 

8D 

03 

D3 

STA 

PBCTL 



1778 









1779 

E9B4 

20 

8A 

EC 

JSR 

SEND IN 

; SEND THE COMMAND FRAME TO A SMART DEVICE 

1780 









1781 

E9B7 

AD 

3F 

02 

LDA 

ERRFLG 



1782 

E9BA 

DO 

03 


BNE 

BADCOM 

; BRANCH IF AN ERROR RECEIVED 


1783 









1784 

E9BC 

98 



TYA 




1785 

E9BD 

DO 

07 


BNE 

ACKREC 

; BRANCH IF ACK RECEIVED 


1786 









1787 









1788 

E9BF 

C6 

36 

BADCOM: DEC 

CRETRY 

i A NACK OR TIME OUT OCCURED 




ERR LINE 

ADDR 

B1 

B2 

B3 B4 

SIO ( SERIAL 

BUS INPUT /OUTPUT CONTROLLER ) 

PAGE 43 

1789 

E9C 1 

10 

B5 


BPL 

COMFRM 

iSO BRANCH IF ANY RETRIES LEFT 


1790 




< 





1791 

E9C3 

4C 

06 

EA 

JMP 

DERR1 

i OTHERWISE, JUMP TO RETURN SECTION 

1792 









1793 









1794 

E9C6 

AD 

03 

03 ACKREC: LDA 

DSTATS 

i ACK WAS RECEIVED 


1795 

E9C9 

10 

OC 


BPL 

WATCOM 

; BRANCH TO WAIT FOR COMPLETE , 


1796 





IF THERE IS 

NO DATA TO BE 

SENT 


1797 









1798 









1799 









1800 





SEND A DATA 

FRAME TO PERIPHERAL 


1801 









1802 

E9CB 

A9 

OD 


LDA 

#CRETRI 

; SET NUMBER OF RETRIES 


1803 

E9CD 

85 

36 


STA 

CRETRY 



1804 









1805 

E9CF 

20 

6A 

EB 

JSR 

LDPNTR 

; LOAD BUFFER POINTER WITH DCB 

INFORMATION 

1806 









1807 

E9D2 

20 

8A 

EC 

JSR 

SEND IN 

i GO SEND THE DATA FRAME TO A SMART DEVICE 

1808 









1809 

E9D5 

F0 

E8 


BEG 

BADCOM 

i BRANCH IF BAD 


1810 









1811 









1812 









1813 





WAIT FOR COMPLETE SIGNAL FROM PERIPHERAL 


1814 









1815 

E9D7 

20 

75 

EC WATCOM: JSR 

STTMOT 

; SET DDEVICE TIME OUT VALUES IN Y, X 

1816 









1817 

E9DA 

A9 

00 


LDA 

#$00 



1818 

E9DC 

8D 

3F 

02 

STA 

ERRFLG 

i CLEAR ERROR FLAG 


1819 









1820 

E9DF 

20 

9B 

EC 

JSR 

WAITER 

» SET UP TIMER AND WAIT 


1821 

E9E2 

FO 

12 


BEG 

DERR 

; BRANCH IF TIME OUT 


1822 









1823 









1824 





DEVICE DID 

NOT TIME OUT 



1825 









1826 

E9E4 

2C 

03 

03 

BIT 

DSTATS 



1827 

E9E7 

70 

07 


BVS 

MODATA 

; BRANCH IF MORE DATA FOLLOWS 


1828 





' 




1829 

E9E9 

AD 

3F 

02 

LDA 

ERRFLG 



1830 

E9EC 

DO 

18 


BNE 

DERR 1 

i BRANCH IF AN ERROR OCCURRED 


1831 

E9EE 

FO 

ID 


BEG 

RETURN 

i OTHERWISE RETURN 


1832 









1833 









1834 









1835 









1836 





RECEIVE A DATA FRAME FROM 

PERIPHERAL 


1837 









1838 

E9F0 

20 

6A 

EB MODATA: JSR 

LDPNTR 

; LOAD BUFFER POINTER WITH DCB 

INFORMATION 

1839 









1840 

E9F3 

20 

EO 

EA 

JSR 

RECEIV 

; GO RECEIVE A DATA FRAME 


1841 









1842 

E9F6 

AD 

3F 

02 

DERR: LDA 

ERRFLG 





ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

SIO ( 

SERIAL BUS INPUT/OUTPUT CONTROLLER ) PAGE 

1843 

1844 

E9F9 

FO 

05 



BEG 

NOTERR 

i BRANCH IF NO ERROR PRECEEDED DATA 

1845 

E9FB 

AD 

19 

03 


LDA 

TSTAT 

i GET TEMP STATUS 

1846 

1847 

1848 

E9FE 

85 

30 



STA 

STATUS 

; STORE IN REAL STATUS 

1849 

EA00 

A5 

30 

NOTERR: 

LDA 

STATUS 


1850 

EA02 

C9 

01 



CMP 

#SUCCES 


1851 

1852 

EA04 

FO 

07 



BEG 

RETURN 

; BRANCH IF COMPLETELY SUCCESSFUL 

1853 

EA06 

C6 

37 

DERR1 : 

DEC 

DRETRY 


1854 

EA08 

30 

03 



BMI 

RETURN 

i BRANCH IF OUT OF DEVICE RETRIES 

1855 

1856 

1857 

1858 

1859 

1860 

EAOA 

4C 

74 

E9 


JMP 

COMMND 

; OTHERWISE, ONE MORE TIME 

1861 

EAOD 

20 

5F 

EC RETURN: 

JSR 

SENDDS 

i DISABLE POKEY INTERRUPTS 

1862 

EA10 

A9 

00 



LDA 

#0 


1863 

EA12 

85 

42 



STA 

CRITIC 


1864 

EA14 

A4 

30 



LDY 

STATUS 

i RETURN STATUS IN Y 

1865 

EA16 

8C 

03 

03 


STY 

DSTATS 

; AND THE DCB STATUS WORD 

1866 

1867 

1868 

1869 

1870 

EA19 

60 




RTS 

RETURN 


1871 





WAIT 

SUBROUTINE 


1872 









1873 





WAITS FOR 

COMPLETE OR ACK 


1874 





RETURNS Y= 

=$FF IF SUCCESSFUL, Y=$00 IF NOT 

1875 









1876 

EA1 A 

A9 

00 

WAIT: 

LDA 

#$00 


1877 

EA1C 

8D 

3F 

02 


STA 

ERRFLG 

; CLEAR ERROR FLAG 

1878 

1879 

EA1F 

18 




CLC 


» LOAD BUFFER POINTER WITH ADDRESS 

1880 

EA20 

A9 

3E 



LDA 

#TEMPLO 

i OF TEMPORARY RAM CELL 

1881 

EA22 

85 

32 



STA 

BUFRLO 


1882 

EA24 

69 

01 



ADC 

#1 


1883 

EA26 

85 

34 



STA 

BFENLO 

; ALSO SET BUFFER END +1 ADDRESS 

1884 

EA28 

A9 

02 



LDA 

#TEMPHI 


1885 

EA2A 

85 

33 



STA 

BUFRHI 


1886 

EA2C 

85 

35 



STA 

BFENHI 

; DONE LOADING POINTER 

1887 

1888 

EA2E 

A9 

FF 



LDA 

#$FF 


1889 

EA30 

85 

3C 



STA 

NQCKSM 

; SET NO CHECKSUM FOLLOWS DATA FLAG 

1890 

1891 

1892 

EA32 

20 

EO 

EA 


JSR 

RECEIV 

> GO RECEIVE A BYTE 

1893 

EA35 

AO 

FF 



LDY 

#$FF 

; ASSUME SUCCESS 

1894 

EA37 

A5 

30 



LDA 

STATUS 


1895 

EA39 

C9 

01 



CMP 

#SUCCES 


1896 

EA3B 

DO 

19 



BNE 

NWOK 

; BRANCH IF IT DID NOT WORK OK 


44 



ERR LINE ADDR B1 B2 B3 B4 SIO < SERIAL BUS INPUT/OUTPUT CONTROLLER ) PAGE 45 

1897 ; 

1898 ; 

1899 

1900 


1901 

EA3D 

AD 

3E 

02 

WOK: 

LDA 

TEMP 

; MAKE SURE THE BYTE SUCCESSFULLY RECEIVED 

1902 

EA40 

C9 

41 



CMP 

#ACK 

; WAS ACTUALLY AN ACK OR COMPLETE 

1903 

EA42 

FO 

21 



BEG 

GOOD 


1904 

EA44 

C9 

43 



CMP 

#COMPLT 


1905 

EA46 

FO 

ID 



BEG 

GOOD 


1906 





/ 




1907 

EA48 

C9 

45 



CMP 

#ERROR 


1908 

EA4A 

DO 

06 



BNE 

NOTDER 

; BRANCH IF DEVICE DID NOT SEND BACK 

1909 





; A DEVICE ERROR CODE 


1910 

EA4C 

A9 

90 



LDA 

#DERROR 


1911 

EA4E 

85 

30 



STA 

STATUS 

; SET DEVICE ERROR STATUS 

1912 

EA50 

DO 

04 



BNE 

NWOK 


1913 





9 




1914 

EA52 

A9 

8B 


NOTDER : 

LDA 

#DNACK 

i OTHERWISE SET NACK STATUS 

1915 

EA54 

85 

30 



STA 

STATUS 


1916 





i 




1917 

EA56 

A5 

30 


NWOK: 

LDA 

STATUS 


1918 

EA58 

C9 

8A 



CMP 

#TIMOUT 


1919 

EA5A 

FO 

07 



BEG 

BAD 

; BRANCH IF TIME OUT 

1920 





# 




1921 

EA5C 

A9 

FF 



LDA 

#*FF 


1922 

EA5E 

8D 

3F 

02 


STA 

ERRFLG 

; SET SOME ERROR FLAG 

1923 

EA61 

DO 

02 



BNE 

GOOD 

; RETURN WITH OUT SETTING Y = 0 

1924 





/ 




1925 

EA63 

AO 

00 


BAD: 

LDY 

#0 


1926 





9 




1927 

EA65 

A5 

30 


GOOD: 

LDA 

STATUS 


1928 

EA67 

8D 

19 

03 


STA 

TSTAT 


1929 

EA6A 

60 




RTS 


i RETURN 


1930 ; 

1931 ; 

1932 i 

1933 ; 

1934 ; 

1935 i SEND SUBROUTINE 

1936 

1937 i SENDS A BUFFER OF BYTES OUT OVER THE SERIAL BUS 

1938 

1939 


1940 

EA6B 

A9 

01 

SEND: LDA 

#SUCCES 

i ASSUME SUCCESS 

1941 

1942 

EA6D 

85 

30 

STA 

STATUS 


1943 

1944 

EA6F 

20 

F2 EB 

JSR 

I 

SENDEN 

; ENABLE SENDING 

1945 

EA72 

AO 

00 

LDY 

#0 


1946 

EA74 

84 

31 

STY 

CHKSUM 

; CLEAR CHECK SUM 

1947 

EA76 

84 

3B 

STY 

CHKSNT 

; CHECKSUM SENT FLAG 

1948 

EA78 

84 

3A 

STY 

XMTDON 

; TRANSMISSION DONE FLAG 


1949 

1950 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

SIO ( 

SERIAL 

BUS INPUT/OUTPUT CONTROLLER ) PAGE 

1951 

EA7A 

B 1 

32 



LDA 

(BUFRLO) > Y 

; PUT FIRST BYTE FROM BUFFER 

1952 

EA7C 

8D 

OD 

D2 


STA 

SEROUT 

; INTO THE SERIAL OUTPUT REGISTER 

1953 









1954 









1955 

EA7F 

85 

31 



STA 

CHKSUM 

; PUT IT IN CHECKSUM 

1956 









1957 

EA81 

A5 

11 

NOTDON: 

LDA 

BRKKEY 


1958 

EA83 

DO 

03 



BNE 

NTBRKO 


1959 

EA85 

4C 

AO 

ED 


JMP 

BROKE 

i JUMP IF BREAK KEY PRESSED 

1960 









1961 

EA88 

A5 

3A 

NTBRKO: 

LDA 

XMTDON 

; LOOP UNTIL TRANSMISSION IS DONE 

1962 

EA8A 

FO 

F5 



BEG 

NOTDON 


1963 









1964 

EA8C 

20 

5F 

EC 


JSR 

SENDDS 

; DISABLE SENDING 

1965 









1966 

EA8F 

60 




RTS 


; RETURN 

1967 









1968 









1969 









1970 









1971 









1972 









1973 





OUTPUT DATA 

NEEDED INTERRUPT SERVICE ROUTINE 

1974 









1975 

EA90 

98 


ISRODN: 

TYA 



1976 

EA91 

48 




PHA 


; SAVE Y REG ON STACK 

1977 









1978 

EA92 

E6 

32 



INC 

BUFRLO 

; INCREMENT BUFFER POINTER 

1979 

EA94 

DO 

02 



BNE 

NOWRPO 


1980 

EA96 

E6 

33 



INC 

BUFRHI 


1981 









1982 

EA98 

A5 

32 

NOWRPO: 

LDA 

BUFRLO 

; CHECK IF PAST END OF BUFFER 

1983 

EA9A 

C5 

34 



CMP 

BFENLO 


1984 

EA9C 

A5 

33 



LDA 

BUFRHI 

; HIGH PART 

1985 

EA9E 

E5 

35 



SBC 

BFENHI 


1986 

EAAO 

90 

1C 



BCC 

NOTEND 

; BRANCH IF NOT PAST END OF BUFFER 

1987 









1988 

EAA2 

A5 

3B 



LDA 

CHKSNT 


1989 

EAA4 

DO 

OB 



BNE 

RELONE 

; BRANCH IF CHECKSUM ALREADY SENT 

1990 









1991 

EAA6 

A5 

31 



LDA 

CHKSUM 


1992 

EAA8 

8D 

OD 

D2 


STA 

SEROUT 

; SEND CHECK SUM 

1993 

EAAB 

A9 

FF 



LDA 

#*FF 


1994 

EAAD 

es 

3B 



STA 

CHKSNT 

; SET CHECKSUM SENT FLAG 

1995 

EAAF 

DO 

09 



BNE 

CHKDON 


1996 









1997 

EAB1 

A5 

10 

RELONE: 

LDA 

POKMSK 

; ENABLE TRANSMIT DONE INTERRUPT 

1998 

EAB3 

09 

08 



ORA 

#$08 


1999 

EAB5 

85 

10 



STA 

POKMSK 


2000 

EAB7 

8D 

OE 

D2 


STA 

IRGEN 


2001 









2002 

EABA 

68 


CHKDON: 

PLA 



2003 

EABB 

A8 




TAY 


i RESTORE Y REG 

2004 

EABC 

68 




PLA 


; RETURN FROM INTERRUPT 


46 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

SIO < 

SERIAL 

BUS INPUT /OUTPUT CONTROLLER ) PAGE 

2005 

2006 
2007 

EABD 

40 




RTI 



2008 

EABE 

AO 

00 

NOTEND: 

LDY 

#0 


2009 

EACO 

B1 

32 



LDA 

(BUFRLO) » Y 

; PUT NEXT BYTE FROM BUFFER 

2010 

2011 

EAC2 

8D 

OD 

D2 


STA 

SEROUT 

; INTO THE SERIAL OUTPUT REGISTER 

2012 

EAC5 

18 




CLC 


iADD IT TO CHECKSUM 

2013 

EAC6 

65 

31 



ADC 

CHKSUM 


2014 

EAC8 

69 

00 



ADC 

#0 


2015 

EACA 

85 

31 



STA 

CHKSUM 


2016 

2017 

2018 

2019 

2020 
2021 
2022 
2023 

EACC 

4C 

BA 

EA 


JMP 

CHKDON 

i GO RETURN 

2024 





TRANSMIT DONE INTERRUPT 

SERVICE ROUTINE 

2025 









2026 

EACF 

A5 

3B 

ISRTD: 

LDA 

CHKSNT 


2027 

EAD1 

FO 

OB 



BEQ 

FOOEY 

; BRANCH IF CHECKSUM NOT YET SENT 

2028 

2029 

EAD3 

85 

3A 



STA 

XMTDON 

.OTHERWISE SET TRANSMISSION DONE FLAG 

2030 

2031 

EADS 

A5 

10 



LDA 

POKMSK 

; DISABLE TRANSMIT DONE INTERRUPT 

2032 

EAD7 

29 

F7 



AND 

#$F7 


2033 

EAD9 

85 

10 



STA 

POKMSK 


2034 

2035 

EADB 

8D 

OE 

D2 


STA 

IRQEN 


2036 

EADE 

68 


FOOEY: 

PLA 


; RETURN FROM INTERRUPT 

2037 

2038 

2039 

2040 

2041 

2042 

2043 

2044 

2045 

EADF 

40 




RTI 



2046 





RECEIVE SUBROUTINE 


2047 





1 




2048 

EAEO 

A9 

00 

RECEIV 

LDA 

#0 


2049 

2050 

EAE2 

AC 

OF 

03 


LDY 

CASFLG 


2051 

2052 

EAE5 

DO 

02 



BNE 

NOCLR 

; BRANCH IF CASSETTE 

2053 

EAE7 

85 

31 



STA 

CHKSUM 

; CLEAR CHKSUM 

2054 

EAE9 

85 

38 

NOCLR: 

STA 

BUFRFL 

; BUFFER FULL FLAG 

2055 

EAEB 

85 

39 



STA 

RECVDN 

; RECEIVE DONE FLAG 


2056 

2057 

2058 


47 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 


SIO ( 

SERIAL 

BUS INPUT/OUTPUT CONTROLLER ) PAGE 

2059 

EAED 

A9 

01 




LDA 

#SUCCES 


2060 

EAEF 

85 

30 




STA 

STATUS 

; SET GOOD STATUS FOR DEFAULT CASE. 

2061 

EAF1 

20 

IB 

EC 



JSR 

RECVEN 

; DO RECEIVE ENABLE 

2062 

EAF4 

A9 

3C 




LDA 

#NCOMHI 

; COMMAND FRAME HI COMMAND 

2063 

EAF6 

8D 

03 

D3 



STA 

PBCTL 

; STORE IN PIA 

2064 

EAF9 

A5 

11 


CHKTIM: 

LDA 

BRKKEY 


2065 

EAFB 

DO 

03 




BNE 

NTBRK1 


2066 

2067 

EAFD 

4C 

AO 

ED 



JMP 

BROKE 

; JUMP IF BREAK KEY PRESSED 

2068 

EB00 

AD 

17 

03 

NTBRK1: 

LDA 

TIMFLG 

; NO, 

2069 

EB03 

FO 

05 




BEQ 

TOUT 

; IF TIMEOUT, GO SET ERROR STATUS 

2070 

EB05 

A5 

39 




LDA 

RECVDN 


2071 

EB07 

FO 

FO 




BEQ 

CHKTIM 

i DONE ? 

2072 

EB09 

60 



GOBACK: 

RTS 



2073 

EBOA 

A9 

8A 


TOUT: 

LDA 

#T I MOUT 

; YES, 

2074 

2075 

2076 

2077 

2078 

2079 

2080 

EBOC 

85 

30 




STA 

STATUS 

i SET TIMEOUT STATUS 

2081 

EBOE 

60 



RRETRN: 

RTS 


; RETURN 

2082 

2083 

2084 

2085 

2086 

2087 

2088 










2089 






SERIAL INPUT READY INTERRUPT SERVICE ROUTINE 

2090 










2091 

EBOF 

98 



ISRSIR 

TYA 



2092 

EB 10 

48 





PHA 


i SAVE Y REG ON STACK 

2093 

2094 

2095 

2096 

EB1 1 

AD 

OF 

D2 



LDA 

SKSTAT 


2097 

EB 14 

8D 

OA 

D2 



STA 

SKRES 

i RESET STATUS REGISTER 

2098 






a-#***#*# 

THIS MAY NOT 

BE THE PLACE TO DO IT ********* 

2099 

2100 
2101 

EB 17 

30 

04 




BMI 

NTFRAM 

i BRANCH IF NO FRAMING ERROR 

2102 

EB 19 

AO 

8C 




LDY 

#FRMERR 


2103 

2104 

EB1B 

84 

30 




STY 

STATUS 

; SET FRAME ERRORR STATUS 

2105 

EB ID 

29 

20 


NTFRAM 

AND 

#$20 


2106 

2107 

EB IF 

DO 

04 



' 

BNE 

NTOVRN 

; BRANCH IF NO OVERRUN ERROR 

2108 

EB21 

AO 

8E 




LDY 

#OVRRUN 


2109 

2110 

EB23 

84 

30 




STY 

STATUS 

; SET OVERRUN ERROR STATUS 

2111 

EB25 

A5 

38 


NTOVRN 

LDA 

BUFRFL 


2112 

EB27 

FO 

13 




BEQ 

NOTYET 

; BRANCH IF BUFFER WAS NOT YET FILLED 


48 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 SIO < 

SERIAL 

BUS INPUT/OUTPUT CONTROLLER ) PAGE 49 

2113 




• 




2114 

EB29 

AD 

OD 

D2 

LDA 

SERIN 

} THIS INPUT BYTE IS THE CHECKSUM 

2115 

EB2C 

C5 

31 


CMP 

CHKSUM 


2116 

EB2E 

F0 

04 


BEG 

SRETRN 

; BRANCH IF CHECKSUMS MATCH 

2117 




t 




2118 

EB30 

AO 

8F 


LDY 

#CHKERR 


2119 

EB32 

84 

30 


STY 

STATUS 

; SET CHECKSUM ERROR STATUS 

2120 




) 




2121 

EB34 

A9 

FF 

SRETRN: 

LDA 

#*FF 

; SET RECEIVE DONE FLAG 

2122 

EB36 

85 

39 


STA 

RECVDN 


2123 




i 




2124 

EB38 

68 


SUSUAL: 

PLA 



2125 

EB39 

A8 



TAY 


; RESTORE Y REG 

2126 

EB3A 

68 



PLA 


; RETURN FROM INTERRUPT 

2127 

EB3B 

40 



RTI 



2128 








2129 








2130 








2131 

EB3C 

AD 

OD 

D2 NOT YET: 

LDA 

SERIN 


2132 

EB3F 

AO 

00 


LDY 

#0 


2133 

EB41 

91 

32 


STA 

( BUFRLO > t Y 

; STORE INPUT REGISTER INTO BUFFER 

2134 




i 




2135 

EB43 

18 



CLC 


; ADD IT TO CHECKSUM 

2136 

EB44 

65 

31 


ADC 

CHKSUM 


2137 

EB46 

69 

00 


ADC 

#0 


2138 

EB48 

85 

31 


STA 

CHKSUM 


2139 




i 




2140 

EB4A 

E6 

32 


INC 

BUFRLO 

; INCREMENT BUFFER POINTER 

2141 

EB4C 

DO 

02 


BNE 

NTWRP 1 


2142 

EB4E 

E6 

33 


INC 

BUFRHI 


2143 




i 




2144 

EB50 

A5 

32 

NTWRP 1 

LDA 

BUFRLO 


2145 

EB52 

C5 

34 


CMP 

BFENLO 


2146 

EB54 

A5 

33 


LDA 

BUFRHI 


2147 

EB56 

E5 

35 


SBC 

BFENHI 


2148 

EB58 

90 

DE 


BCC 

SUSUAL 

; BRANCH IF NEW BUFFER ADDRESS IS IN BUFFER 

2149 




; 




2150 

EB5A 

A5 

3C 


LDA 

NOCKSM 


2151 

EB5C 

FO 

06 


BEG 

GOON 

; BRANCH IF A CHECKSUM WILL FOLLOW DATA 

2152 




i 




2153 

EB5E 

A9 

00 


LDA 

#0 


2154 

EB60 

85 

3C 


STA 

NOCKSM 

; CLEAR NO CHECKSUM FLAG 

2155 




i 




2156 

EB62 

FO 

DO 


BEG 

SRETRN 

> GO RETURN AND SET RECEIVE DONE FLAG 

2157 




i 




2158 




i 




2159 

EB64 

A9 

FF 

GOON: 

LDA 

#*FF 


2160 

EB66 

85 

38 


STA 

BUFRFL 

; SET BUFFER FULL FLAG 

2161 




i 




2162 

EB68 

DO 

CE 


BNE 

SUSUAL 

; GO RETURN 

2163 




i 




2164 




i 




2165 




» 




2166 




i 






ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

SIO ( 

SERIAL 

BUS INPUT/OUTPUT CONTROLLER > PAGE 

2167 

2168 

2169 

2170 









2171 





LOAD 

BUFFER 

POINTER SUBROUTINE 

2172 

2173 

2174 





LOAD 

BUFFER 

POINTER WITH 

DCB BUFFER INFORMATION 

2175 

EB6A 

18 


LDPNTR : 

CLC 



2176 

EB6B 

AD 

04 

03 


LDA 

DBUFLO 


2177 

EB6E 

85 

32 



STA 

BUFRLO 


2178 

EB70 

6D 

08 

03 


ADC 

DBYTLO 


2179 

2180 

EB73 

85 

34 



STA 

BFENLO 

; ALSO SET BUFFER END + 1 ADDRESS 

2181 

EB75 

AD 

05 

03 


LDA 

DBUFHI 


2182 

EB78 

85 

33 



STA 

BUFRHI 


2183 

EB7A 

6D 

09 

03 


ADC 

DBYTHI 


2184 

2185 

EB7D 

85 

35 



STA 

BFENHI 


2186 

2187 

2188 

2189 

2190 

2191 

2192 

2193 

2194 

EB7F 

60 




RTS 


; RETURN 

2195 





CASSETTE HANDLING CODE 


2196 









2197 

EB80 

AD 

03 

03 CASENT: 

LDA 

DSTATS 


2198 

2199 

EB83 

10 

2E 



BPL 

CASRED 

i BRANCH IF INPUT FROM CASSETTE 

2200 





WRITE 

A RECORD 


2201 

2202 

EB85 

A9 

CC 



LDA 

#B600L0 

; SET BAUD RATE TO 600 

2203 

EB87 

8D 

04 

D2 


STA 

AUDF3 


2204 

EB8A 

A9 

05 



LDA 

#B600HI 


2205 

EB8C 

8D 

06 

D2 


STA 

AUDF4 


2206 

2207 

2208 

EB8F 

20 

F2 

EB 


JSR 

SENDEN 

j TURN ON POKEY MARK TONE 

2209 

EB92 

AO 

OF 



LDY 

#WSIRG 

; LOAD SHORT WRITE INTER RECORD GAP TIME 

2210 

EB94 

AD 

OB 

03 


LDA 

DAUX2 


2211 

2212 

EB97 

30 

02 



Bill 

SRTIRO 

; BRANCH IF SHORT GAP IS DESIRED 

2213 

EB99 

AO 

B4 



LDY 

#WIRGLO 

; SET WRITE IRG TIME 

2214 

EB9B 

A2 

00 

SRTIRO: 

LDX 

#WIRGHI 


2215 

2216 

EB9D 

20 

B9 

ED 


JSR 

SETVBX 


2217 

EBAO 

A9 

34 



LDA 

#MOTRGO 


2218 

2219 

EBA2 

8D 

02 

D3 

i 


STA 

PACTL 

i TURN ON MOTOR 

2220 

EBA5 

AD 

17 

03 TIMIT: 

LDA 

TIMFLG 

; LOOP UNTIL DONE 


50 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

SIO < 

SERIAL 

BUS INPUT/OUTPUT CONTROLLER ) PAGE 51 

2221 

EBA8 

DO 

FB 



BNE 

TIMIT 


2222 









2223 

EBAA 

20 

6A 

EB 


JSR 

LDPNTR 

.LOAD BUFFER POINTER WITH DCB INFORMATION 

2224 









2225 

EBAD 

20 

6B 

EA 


JSR 

SEND 

i SEND A BUFFER 

2226 









2227 

EBBO 

4C 

DF 

EB 


JMP 

CRETRN 

;G0 RETURN 

2228 









2229 









2230 









2231 





RECEIVE A RECORD 


2232 









2233 

EBB3 

A9 

FF 

CASRED: 

LDA 

#*FF 


2234 

EBBS 

8D 

OF 

03 


STA 

CASFLG 

i SET SET CASSETTE FLAG 

2235 









2236 

EBB8 

AO 

OA 



LDY 

#RSIRG 

i LOAD SHORT READ INTER RECORD GAP TIME 

2237 

EBBA 

AD 

OB 

03 


LDA 

DAUX2 


2238 

EBBD 

30 

02 



BMI 

SRTIR1 

i BRANCH IF SHORT GAP IS DESIRED 

2239 









2240 

EBBF 

AO 

78 



LDY 

#RIRGLO 

; SET TIME OUT FOR READ IRG 

2241 

EBC1 

A2 

00 

SRTIR1: 

LDX 

#RIRGHI 


2242 

EBC3 

20 

B9 

ED 


JSR 

SETVBX 


2243 









2244 

EBC6 

A9 

34 



LDA 

#MQTRGO 


2245 

EBC8 

8D 

02 

D3 


STA 

PACTL 

; TURN ON MOTOR 

2246 









2247 

EBCB 

AD 

17 

03 TIMIT1: 

LDA 

TIMFLG 

; LOOP UNTIL DONE 

2248 

EBCE 

DO 

FB 



BNE 

TIMIT1 


2249 









2250 

EBDO 

20 

6A 

EB 


JSR 

LDPNTR 

iLOAD BUFFER POINTER WITH DCB INFORMATION 

2251 









2252 

EBD3 

20 

75 

EC 


JSR 

STTMOT 

i SET DEVICE TIME OUT IN Y, X 

2253 

EBD6 

20 

B9 

ED 


JSR 

SETVBX 


2254 









2255 

EBD9 

20 

10 

ED 


JSR 

BEGIN 

; SET INITIAL BAUD RATE 

2256 









2257 

EBDC 

20 

EO 

EA 


JSR 

RECEIV 

;G0 RECEIVE A BLOCK 

2258 









2259 

EBDF 

AD 

OB 

03 CRETRN: 

LDA 

DAUX2 


2260 

EBE2 

30 

05 



BMI 

SRTIR2 

; BRANCH IF DOING SHORT INTER RECORD GAPS 

2261 





DON'T TURN 

OFF CASSETTE MOTOR 

2262 

EBE4 

A9 

3C 



LDA 

#MQTRST 


2263 

EBE6 

8D 

02 

D3 


STA 

PACTL 

i TURN OFF MOTOR 

2264 





: 




2265 

EBE9 

4C 

OD 

EA SRTIR2: 

JMP 

RETURN 

; GO RETURN 

2266 









2267 









2268 









2269 









2270 









2271 

EBEC 

A9 

00 

JTIMER 

LDA 

#*00 


2272 

OOEB 



JTADRH 

= 

JTIMER/256 

; HI BYTE OF JUMP TIMER ROUTINE ADDR 

2273 

OOEC 



JTADRL 

= 

( -256 ) *JTADRH+ JTIMER 

2274 

EBEE 

8D 

17 

03 


STA 

TIMFLG 

i SET TIME OUT FLAG 



SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) 


PAGE 52 


ERR LINE ADDR B1 B2 B3 B4 

2275 EBF1 60 RTS 

2276 ; 

2277 ; 

2278 ; 

2279 i 

2280 
2281 


2282 





; SEND ENABLE 

SUBROUTINE 


2283 





; 



2284 

EBF2 

A9 

07 


SENDEN: LDA 

#*07 

; MASK OFF PREVIOUS SERIAL BUS CONTROL BITS 

2285 

EBF4 

2D 

32 

02 

AND 

SSKCTL 


2286 

EBF7 

09 

20 


ORA 

#*20 

; SET TRANSMIT MODE 

2287 





i 



2288 

EBF9 

AC 

00 

03 

LDY 

DDEVIC 


2289 

EBFC 

CO 

60 


CP Y 

#C ASET 


2290 

EBFE 

DO 

OC 


BNE 

NOTCAS 

; BRANCH IF NOT CASSETTE 

2291 





i 



2292 

ECOO 

09 

08 


ORA 

#*08 

; SET THE FSK OUTPUT BIT 

2293 





; 



2294 

EC 02 

AO 

07 


LDY 

#LOTONE 

; SET FSK TONE FREQUENCIES 

2295 

EC04 

8C 

02 

D2 

STY 

AUDF2 


2296 

EC 07 

AO 

05 


LDY 

#HITONE 


2297 

EC09 

8C 

00 

D2 

STY 

AUDF1 


2298 





I 



2299 

ECOC 

8D 

32 

02 

NOTCAS: STA 

SSKCTL 

; STORE NEW VALUE TO SYSTEM MASK 

2300 

EC OF 

8D 

OF 

D2 

STA 

SKCTL 

; STORE TO ACTUAL REGISTER 

2301 





; 



2302 

EC 12 

A9 

C7 


LDA 

#*C7 

; MASK OFF PREVIOUS SERIAL BUS INTERRUPT BITS 

2303 

EC 14 

25 

10 


AND 

PQKMSK 


2304 

EC 16 

09 

10 


ORA 

#*10 

; ENABLE OUTPUT DATA NEEDED INTERRUPT 

2305 





i 



2306 





; 



2307 

EC 18 

4C 

31 

EC 

JMP 

CONTIN 

; GO CONTINUE IN RECEIVE ENABLE SUBROUTINE 


2308 ; 

2309 ; 

2310 ; 

2311 ; 

2312 ; 

2313 

2314 ; 

2315 i 

2316 ; 

2317 ; 

2318 i RECEIVE ENABLE SUBROUTINE 

2319 ; 


2320 

EC IB 

A9 

07 


RECVEN: LDA 

#*07 

i MASK OFF PREVIOUS SERIAL BUS CONTROL BITS 

2321 

EC ID 

2D 

32 

02 

AND 

SSKCTL 


2322 

EC20 

09 

10 


ORA 

#*10 

i SET RECEIVE MODE ASYNCH. 

2323 

EC 22 

8D 

32 

02 

STA 

SSKCTL 

; STORE NEW VALUE TO SYSTEM MASK 

2324 

2325 

EC25 

8D 

OF 

D2 

STA 

SKCTL 

; STORE TO ACTUAL REGISTER 

2326 

2327 

EC28 

8D 

OA 

D2 

STA 

i 

SKRES 

; RESET SERIAL PORT/KEYBOARD STATUS REGISTER 

2328 

EC2B 

A9 

C7 


LDA 

#*C7 

iMASK OFF PREVIOUS SERIAL BUS INTERRUPT BITS 



ERR LINE 

ADDR 

B1 

B2 

B3 B4 

SIO ( 

SERIAL 

BUS INPUT/OUTPUT CONTROLLER ) PAGE 

2329 

EC2D 

25 

10 



AND 

PQKMSK 


2330 

EC2F 

09 

20 



QRA 

#$20 

.ENABLE RECEIVE INTERRUPT 

2331 

EC31 

85 

10 

CONTIN: 

STA 

PQKMSK 

; STORE NEW VALUE TO SYSTEM MASK 

2332 

EC33 

8D 

OE 

D2 


STA 

IRQEN 

i STORE TO ACTUAL REGISTER 

2333 

2334 

2335 

EC 36 

A9 

28 



LDA 

#$28 

i CLOCK CH. 3 WITH 1.79 MHZ 

2336 

EC 38 

8D 

08 

D2 


STA 

AUDCTL 

i CLOCK CH. 4 WITH CH. 3 

2337 

2338 

EC3B 

A2 

06 



LDX 

#6 

; SET PURE TONES. NO VOLUME 

2339 

EC 3D 

A9 

A8 



LDA 

#$A8 


2340 

EC3F 

A4 

41 



LDY 

SOUNDR 

; TEST QUIET I/O FLAG 

2341 

EC 41 

DO 

02 



BNE 

NQISE1 

; NE IS NORMAL (NOISY) 

2342 

EC 43 

A9 

AO 



LDA 

#$A0 


2343 

EC45 

9D 

01 

D2 N0ISE1: 

STA 

AUDC1, X 


2344 

EC 48 

CA 




DEX 



2345 

EC 49 

CA 




DEX 



2346 

2347 

EC4A 

10 

F9 



BPL 

N0ISE1 


2348 

EC4C 

A9 

AO 



LDA 

#$A0 


2349 

EC4E 

8D 

05 

D2 


STA 

AUDC3 

; TURN OFF SOUND ON CHANNEL 3 

2350 

EC51 

AC 

00 

03 


LDY 

DDEVIC 


2351 

EC 54 

CO 

60 



CPY 

#CAS£T 


2352 

EC 56 

FO 

06 



BEQ 

CAS31 

; BRANCH IF CASSETTE IS DESIRED 

2353 

EC 58 

8D 

01 

D2 


STA 

AUDCI 

.OTHERWISE TURN OFF CHANNELS 1 AND 2 

2354 

2355 

2356 

EC5B 

8D 

03 

D2 


STA 

AUDC2 


2357 

EC5E 

60 


CAS31 : 

RTS 


; RETURN 

2358 

2359 

2360 

2361 

2362 

2363 

2364 

2365 

2366 

2367 









2368 





DISABLE SEND 

AND DISABLE 

RECEIVE SUBROUTINES 

2369 









2370 

EC5F 

EA 


SENDDS: 

NOP 



2371 

EC 60 

A9 

C7 

RECVDS: 

LDA 

#$C7 

. MASK OFF SERIAL BUS INTERRUPTS 

2372 

EC 62 

25 

10 



AND 

POKMSK 


2373 

EC 64 

85 

10 



STA 

POKMSK 

; STORE NEW VALUE TO SYSTEM MASK 

2374 

2375 

EC 66 

8D 

OE 

D2 


STA 

IRQEN 

; STORE TO ACTUAL REGISTER 

2376 

EC 69 

A2 

06 



LDX 

#6 


2377 

EC6B 

A9 

00 



LDA 

#0 


2378 

EC6D 

9D 

01 

D2 ZERIT: 

STA 

AUDC 1 . X 


2379 

EC 70 

CA 




DEX 



2380 

EC 71 

CA 




DEX 



2381 

2382 

EC 72 

10 

F9 



BPL 

ZERIT 

i TURN OFF AUDIO VOLUME 


53 



ERR LINE ADDR B1 §2 B3 B4 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) 


PAGE 


2383 

2384 

2385 

2386 

2387 

2388 

2389 

2390 

2391 

2392 

2393 

2394 

2395 

2396 

2397 

2398 

2399 

2400 

2401 

2402 

2403 

2404 

2405 

2406 

2407 

2408 

2409 

2410 

2411 

2412 

2413 

2414 

2415 

2416 

2417 

2418 


EC74 60 


RTS 


i RETURN 


2429 

2430 

2431 

2432 

2433 

2434 

2435 

2436 


EC7E 

EC7F 


SET DDEVICE TIME OUT VALUES IN Y, X SUBROUTINE 


EC 75 AD 06 03 
EC 78 6A 
EC 79 6 A 

EC 7 A A8 
EC7B 29 3F 
EC7D A A 


98 

6A 


EC80 29 CO 
EC 82 A8 

EC83 60 


STTMOT: LDA 
ROR 
ROR 
TAY 
AND 
TAX 

/ 

TYA 

ROR 

AND 

TAY 

» 

RTS 


DTIMLO 

A 

A 

#$3F 


A 

#$C0 


; GET DEVICE TIME OUT IN 1 SECOND INCR 
; PUT 6 HI BITS IN X, LO 2 BITS IN Y 

TEMP SAVE 

MASK OFF 2 HI BITS 

THIS IS HI BYTE OF TIME OUT 

RESTORE 

MASK OFF ALL BUT 2 HI BITS 
THIS IS LQ BYTE OF TIME OUT 


2419 

EC 84 

OF 

EB 

INTTBL: 

. WORD 

ISRSIR 

; SERIAL INPUT READY 



2420 

EC 86 

90 

EA 


. WORD 

ISRODN 

i OUTPUT DATA NEEDED 



2421 

EC 88 

CF 

EA 


. WORD 

ISRTD 

; TRANSMISSION DONE 



2422 




j 






2423 

OOEB 



SIRHI 

= 

ISRSIR/256 

; SERIAL INPUT READY 

I SR 

ADDRESS 

2424 

OOOF 



SIRLO 

= 

( -256 >*SIRHI+ ISRSIR 



2425 

OOEA 



ODNHI 

= 

ISRODN/256 

; OUTPUT DATA NEEDED 

I SR 

ADDRESS 

2426 

0090 



ODNLO 

= 

( -256 ) *ODNH I + I SRODN 



2427 

OOEA 



TDHI 

= 

ISRTD/256 

; TRANSMISSION DONE 

ISR 

ADDRESS 

2428 

OOCF 



TDLO 

= 

<-256>*TDHI+ISRTD 




SEND A DATA FRAME TO AN INTELLIGENT PERIPHERAL SUBROUTINE 


EC8A A2 01 


SENDIN: LDX 


#$01 


54 
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SIO ( 

SERIAL 

BUS INPUT/OUTPUT CONTROLLER ) PAGE 

2437 

EC8C 

AO 

FF 

DELAVO: 

LDY 

#*FF 


2438 

EC8E 

88 


DELAY 1: 

DEY 



2439 

EC8F 

DO 

FD 



BNE 

DELAY 1 


2440 

EC91 

CA 




DEX 



2441 

2442 

EC92 

DO 

F8 



BNE 

DELAYO 


2443 

2444 

EC 94 

20 

6B 

EA 


JSR 

SEND 

; GO SEND THE DATA FRAME 

2445 

EC 97 

AO 

02 



LDY 

#CT IMLO 

; SET ACK TIME OUT 

2446 

EC 99 

A2 

00 



LDX 

#CTIMHI 


2447 

EC9B 

20 

B9 

ED WAITER: 

JSR 

SETVBX 


2448 

2449 

EC9E 

20 

1A 

EA 


JSR 

WAIT 

i WAIT FOR ACK 

2450 

2451 

ECA1 

98 




TYA 


; IF Y=Oi A TIME OUT OR NACK OCCURED 

2452 

2453 

2454 

2455 

2456 

2457 

2458 

2459 

2460 

2461 

2462 

2463 

2464 

ECA2 

60 




RTS 


; RETURN 

2465 





COMPUTE VALUE FOR POKEY 

FREQ REGS FOR THE BAUD RATE AS 

2466 





MEASURED BY 

AN INTERVAL 

OF THE ' VCOUNT ' TIMER. 

2467 









2468 

EC A3 

8D 

10 

03 COMPUT: 

STA 

TIMER2 


2469 

ECA6 

8C 

11 

03 


STY 

TIMER2+1 

i SAVE FINAL TIMER VALUE 

2470 

ECA9 

20 

04 

ED 


JSR 

ADJUST 

; ADJUST VCOUNT VALUE 

2471 

EC AC 

8D 

10 

03 


STA 

TIMER2 

; SAVE ADJUSTED VALUE 

2472 

ECAF 

AD 

OC 

03 


LDA 

TIMER1 


2473 

ECB2 

20 

04 

ED 


JSR 

ADJUST 

; ADJUST 

2474 

ECB5 

8D 

OC 

03 


STA 

TIMER1 

.SAVE ADJUSTED TIMER1 VALUE 

2475 

ECB8 

AD 

10 

03 


LDA 

TIMER2 


2476 

ECBB 

38 




SEC 



2477 

ECBC 

ED 

OC 

03 


SBC 

TIMER1 


2478 

ECBF 

8D 

12 

03 


STA 

TEMPI 

i FIND VCOUNT DIFFERENCE 

2479 

ECC2 

AD 

11 

03 


LDA 

TIMER2+1 


2480 

ECC5 

38 




SEC 



2481 

ECC6 

ED 

OD 

03 


SBC 

TIMER 1+1 


2482 

ECC9 

A8 




TAY 


» FIND VBLANK COUNT DIFFERENCE 

2483 






. IF 

PALFLG 


2484 






LDA 

#-$9C 


2485 




HITIMR 

CLC 



2486 






ADC 

#*9C 


2487 






. END IF 


2488 






. IF 

PALFLG- 1 


2489 

ECCA 

A9 

7D 



LDA 

#-*83 


2490 

ECCC 

18 


HITIMR 

CLC 




55 
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ADDR 

B1 

B2 

B3 B4 
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2491 

ECCD 

69 

83 



ADC 

#*83 

; ACCUMULATE MULTIPLICATION 

2492 






. END IF 



2493 

ECCF 

88 




DEY 



2494 

EC DO 

10 

FA 



BPL 

HITIMR 

; DONE? 

2495 

ECD2 

18 




CLC 



2496 

ECD3 

6D 

12 

03 


ADC 

TEMPI 

; TOTAL VCOUNT DIFFERENCE 

2497 

ECD6 

AS 



FINDX: 

TAY 


i SAVE AC CUM 

2498 

ECD7 

4A 




LSR 

A 


2499 

ECD8 

4A 




LSR 

A 


2500 

ECD9 

4A 




LSR 

A 


2501 

EC DA 

OA 




ASL 

A 


2502 

ECDB 

38 




SEC 



2503 

EC DC 

E9 

16 



SBC 

#22 

; ADJUST TABLE INDEX 

2504 

ECDE 

AA 




TAX 


; DIVIDE INTERVAL BY 4 TO GET TABLE INDEX 

2505 

ECDF 

98 




TYA 


/RESTORE £ CCUM 

2506 

ECEO 

29 

07 



AND 

#7 


2507 

ECE2 

A8 




TAY 


; PULL OFF 3 LO BITS OF INTERVAL 

2508 

ECE3 

A9 

F5 



LDA 

#~11 


2509 

ECE5 

18 



DOINTP 

CLC 



2510 

ECE6 

69 

OB 



ADC 

#11 

; ACCUMULATE INTERPOLATION CONSTANT 

2511 

ECE8 

88 




DEY 



2512 

ECE9 

10 

FA 



BPL 

DOINTP 

/ INTERPOLATION CONSTANT COMPUTATION DONE? 

2513 





i 




2514 

ECEB 

AO 

00 


ENINTP. 

LDY 

#0 


2515 

EC ED 

8C 

OE 

03 


STY 

ADDCOR 

/CLEAR ADDITION CORRECTION FLAG 

2516 

ECFO 

38 




SEC 



2517 

ECF 1 

E9 

07 



SBC 

#7 

/ADJUST INTERPOLATION CONSTANT 

2518 

ECF3 

10 

03 



BPL 

PLUS 


2519 

ECF5 

CE 

OE 

03 


DEC 

ADDCQR 


2520 

ECF8 

18 



PLUS: 

CLC 



2521 

ECF9 

7D 

DO 

ED 


ADC 

POKTAB, X 

; ADD CONSTANT TO LO BYTE TABLE VALUE 

2522 

ECFC 

A8 




TAY 


i LO BYTE POKEY FREQ VALUE 

2523 

ECFD 

AD 

OE 

03 


LDA 

ADDCOR 


2524 

EDOO 

7D 

D1 

ED 


ADC 

POKTAB+1 » X 

; ADD CARRY TO HI BYTE TABLE VALUE 

2525 





i HI BYTE POKEY 

FREQ VALUE 


2526 

ED03 

60 




RTS 



2527 





# 




2528 









2529 









2530 






ROUTINE 

TO ADJUST 

VCOUNT VALUE 

2531 









2532 

ED04 

C9 

7C 


ADJUST 

CMP 

#$7C 


2533 

ED06 

30 

04 



BMI 

ADJ1 

/LARGER THAN '7C ' ? 

2534 

ED08 

38 




SEC 


; YES/ 

2535 

ED09 

E9 

7C 



SBC 

#$7C 


2536 

EDOB 

60 




RTS 



2537 

EDOC 

18 



ADJ1: 

CLC 



2538 






. IF 

PALFLG 


2539 






ADC 

#$20 


2540 






. END IF 



2541 






. IF 

PALFLG- 1 


2542 

EDOD 

69 

07 



ADC 

#$7 


2543 






. ENDIF 



2544 

EDOF 

60 




RTS 





ERR LINE ADDR B1 B2 B3 B4 
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2545 

2546 

2547 ; 

2548 ; 

2549 

2550 ; 

2551 ; 

2552 ; INITIAL BAUD RATE MEASUREMENT — USED TO SET THE 

2553 ; BAUD RATE AT THE START OF A RECORD. 

2554 

2555 ; IT IS ASSUMED THAT THE FIRST TWO BYTES OF EVERY 

2556 i RECORD ARE 'AA' HEX. 

2557 ; 


2558 

ED10 

A5 

11 


BEGIN: 

LDA 

BRKKEY 


2559 

ED12 

DO 

03 



BNE 

NTBRK2 


2560 

ED 14 

4C 

AO 

ED 


UMP 

BROKE 

; JUMP IF BREAK KEY PRESSED 

2561 





i 




2562 

ED17 

78 



NTBRK2: 

SEI 



2563 





# 




2564 

ED18 

AD 

17 

03 


LDA 

TIMFLG 


2565 

ED1B 

DO 

02 



BNE 

0KTIM1 

; BRANCH IF NOT TIMED OUT 

2566 

ED1D 

FO 

25 



BEG 

TOUTl 

; BRANCH IF TIME OUT 

2567 





/ 




2568 

ED1F 

AD 

OF 

D2 

0KTIM1: 

LDA 

SKSTAT 


2569 

ED22 

29 

10 



AND 

#*10 

;READ SERIAL PORT 

2570 

ED24 

DO 

EA 



BNE 

BEGIN 

; START BIT? 

2571 

ED26 

8D 

16 

03 


STA 

SAVIO 

; SAVE SER. DATA IN 

2572 

ED29 

AE 

OB 

D4 


LDX 

VCOUNT 

iREAD VERTICAL LINE COUNTER 

2573 

ED2C 

A4 

14 



LDY 

RTCLOK+2 

; READ LO BYTE OF VBLANK CLOCK 

2574 

ED2E 

8E 

OC 

03 


STX 

TIMER 1 


2575 

ED31 

8C 

OD 

03 


STY 

TIMER1+1 

; SAVE INITIAL TIMER VALUE 

2576 





i 




2577 

ED34 

A2 

01 



LDX 

#1 

; SET MODE FLAG 

2578 

ED36 

8E 

15 

03 


STX 

TEMP3 


2579 

ED39 

AO 

OA 



LDY 

#10 

i SET BIT COUNTER FOR 10 BITS 

2580 

ED3B 

A5 

11 


COUNT: 

LDA 

BRKKEY 


2581 

ED3D 

FO 

61 



BEG 

BROKE 

; BRANCH IF BREAK KEY PRESSED 

2582 





i 




2583 

ED3F 

AD 

17 

03 


LDA 

TIMFLG 


2584 

ED42 

DO 

04 



BNE 

OKTIMR 

; BRANCH IF NOT TIMED OUT 

2585 

ED44 

58 



TOUTl : 

CLI 



2586 

ED45 

4C 

OA 

EB 


JMP 

TOUT 

; BRANCH IF TIME OUT 

2587 





/ 




2588 

ED48 

AD 

OF 

D2 

OKTIMR: 

LDA 

SKSTAT 


2589 

ED4B 

29 

10 



AND 

#*10 

iREAD SERIAL PORT 

2590 

ED4D 

CD 

16 

03 


CMP 

SAVIO 

iDATA IN CHANGED YET? 

2591 

ED50 

FO 

E9 



BEG 

COUNT 


2592 

ED52 

8D 

16 

03 


STA 

SAVIO 

; YES/ SAVE SER. DATA IN 

2593 

ED55 

88 




DEY 


;DECR. BIT COUNTER 

2594 

ED56 

DO 

E3 



BNE 

COUNT 

; DONE? 

2595 





; 




2596 

ED58 

CE 

15 

03 


DEC 

TEMP3 

; YES, 

2597 

ED5B 

30 

12 



BMI 

GOREAD 

iDONE WITH BOTH MODES? 

2598 

ED5D 

AD 

OB 

D4 


LDA 

VCOUNT 




ERR LINE AD DR B1 B2 B3 B4 


SIO ( SERIAL 


2599 

ED60 

A4 

14 


LDY 

2600 

ED62 

20 

A3 

EC 

JSR 

2601 

ED65 

8C 

EE 

02 

STY 

2602 

ED68 

8D 

EF 

02 

STA 

2603 

ED6B 

AO 

09 


LDY 

2604 

ED6D 

DO 

CC 


BNE 

2605 






2606 

ED6F 

AD 

EE 

02 

SQREAD: LDA 

2607 

ED72 

8D 

04 

D2 

STA 

2608 

ED75 

AD 

EF 

02 

LDA 

2609 

ED78 

8D 

06 

D2 

STA 

2610 

ED7B 

A9 

00 


LDA 

2611 

ED7D 

8D 

OF 

D2 

STA 

2612 

ED80 

AD 

32 

02 

LDA 

2613 

ED83 

8D 

OF 

D2 

STA 

2614 

ED86 

A9 

55 


LDA 

2615 

ED88 

91 

32 


STA 

2616 

ED8A 

C8 



INY 

2617 

ED8B 

91 

32 


STA 

2618 

ED8D 

A9 

AA 


LDA 

2619 

ED8F 

85 

31 


STA 

2620 

ED91 

18 



CLC 

2621 

ED92 

A5 

32 


LDA 

2622 

ED94 

69 

02 


ADC 

2623 

ED96 

85 

32 


STA 

2624 

ED98 

A5 

33 


LDA 

2625 

ED9A 

69 

00 


ADC 

2626 

ED9C 

85 

33 


STA 

2627 

ED9E 

58 



CLI 

2628 

ED9F 

60 



RTS 

2629 






2630 






2631 






2632 

EDAO 

20 

5F 

EC 

BROKE: JSR 

2633 

EDA3 

A9 

3C 


LDA 

2634 

EDA5 

8D 

02 

D3 

STA 

2635 

EDA8 

8D 

03 

D3 

STA 

2636 






2637 

EDAB 

A9 

80 


LDA 

2638 

EDAD 

85 

30 


STA 

2639 






2640 

EDAF 

AE 

18 

03 

LDX 

2641 

EDB2 

9A 



TXS 

2642 






2643 

EDB*3 

C6 

11 


DEC 

2644 

EDB5 

58 



CLI 

2645 






2646 

EDB6 

4C 

OD 

EA 

JMP 

PAA7 







2648 

2649 

2650 

2651 

2652 EDB9 A9 EC 


SETVBX: LDA 


BUS INPUT/OUTPUT CONTROLLER ) PAGE 58 

RTCLOK+2 iREAD TIMER LO & HI BYTES 
COMPUT ;N0, COMPUTE BAUD RATE 

CBAUDL 

CBAUDH , SET BAUD RATE INTO RAM CELLS 

#9 ; SET BIT COUNTER FOR 9 BITS 

COUNT 

CBAUDL 

AUDF3 

CBAUDH 

AUDF4 ; SET POKEY FREQ REGS FOR BAUD RATE 

#0 

SKSTAT 

SSKCTL 

SKSTAT , INIT. POKEY SERIAL PORT 

#$55 

( BUFRLO > , Y /STORE '$55' AS FIRST RCV. BUFFER 

< BUFRLO > , Y 
#$AA 

CHKSUM /STORE CHECKSUM FOR 2 BYTES OF '$AA ' 

BUFRLO 

#2 

BUFRLO 

BUFRHI 

#0 

BUFRHI i INCR. BUFFER POINTER BY 1 


SENDDS ; BREAK KEY WAS PRESSED, SO PREPARE 

#MOTRST , TO RETURN 

PACTL , TURN OFF MOTOR 

PBCTL ; RAISE NOT COMMAND LINE 

#BRKABT 

STATUS ; STORE BREAK ABORT STATUS CODE 

STACKP 

; RESTORE STACK POINTER 

BRKKEY ; SET BREAK KEY FLAG TO NONZERO 

, ALLOW IRQ'S 

RETURN , GO RETURN 


#JTADRL 


,-STORE TIME OUT ROUTINE ADDRESS 
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2653 EDBB 8D 26 02 

2654 EDBE A9 EB 

2655 EDCO 8D 27 02 

2656 

2657 EDC3 A9 01 

2658 

2659 EDC5 78 

2660 EDC6 20 5C E4 

2661 EDC9 A9 01 

2662 EDCB 8D 17 03 

2663 EDCE 58 

2664 EDCF 60 

2665 

2666 

2667 

2668 

2669 

2670 

2671 

2672 

2673 

2674 

2675 

2676 

2677 

2678 

2679 

2680 
2681 
2682 

2683 

2684 

2685 

2686 

2687 

2688 

2689 

2690 

2691 


STA CDTMA1 

LDA #JTADRH 

STA CDTMA1+1 

LDA #1 ; SET FOR TIMER 1 

SEI ; THE SETVBL ROUTINE NEEDS THIS TO CUT SHORT 

JSR SETVBV i ANY VBLANKS THAT OCCUR 

LDA #1 ; SET FOR TIMER 1 

STA TIMFLG ; SET FLAG TO NOT TIMED OUT 

CLI 


' VCGUNT ' INTERVAL TIMER MEASUREMENT — TO — POKEY FREQ REG VALUE 
CONVERSION TABLE 


THE VALUES STORED IN THE TABLE ARE 'AUDF+7'. 

THE FOLLOWING FORMULAS WERE USED TO DETERMINE THE TABLE VALUES: 

F OUT= F IN/ ( 2* ( AUDF+M ) ) , WHERE F IN=1. 78979 MHZ. Z>. M=7 

FROM THIS WAS DERIVED THE FORMULA USED TO COMPUTE THE 
TABLE VALUES BASED ON A MEASUREMENT OF THE PERIOD BY 
AN INTERVAL OF THE 'VCOUNT' TIMER. 

AUDF+7=( 11. 365167>*T OUT > WHERE T QUT=# OF COUNTS 
(127 USEC. RESOLUTION) OF 'VCOUNT' FOR 1 
CHARACTER TIME (10 BIT TIMES). 


2692 

2693 

2694 

2695 

2696 

2697 

2698 

2699 

EDDO 

E8 

03 

. WORD 
. WORD 
. WORD 
. WORD 
POKTAB: .WORD 

2700 

EDD2 

43 

04 

. WORD 

2701 

EDD4 

9E 

04 

. WORD 

2702 

EDD6 

F9 

04 

. WORD 

2703 

EDD8 

54 

05 

. WORD 

2704 

EDDA 

AF 

05 

. WORD 

2705 

EDDC 

OA 

06 

. WORD 

2706 

EDDE 

65 

06 

. WORD 


AUDF+7 

3AUD RATE 

VCOUNT INTERVAL 

$27C 

1407 

56 

$2D7 

1231 

64 

$332 

1094 

72 

$38D 

985 

80 

$3E8 

895 

88 

$443 

820 

96 

$49E 

757 

104 

$4F9 

703 

112 

$554 

656 

120 

$5AF 

615 

128 

$60A 

579 

136 

$665 

547 

144 
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2707 

EDEO 

CO 

06 

. WORD 

$6C0 

; 518 

152 

2708 

EDE2 

1A 

07 

. WORD 

$71 A 

i 492 

160 

2709 

EDE4 

75 

07 

. WORD 

$775 

; 469 

168 

2710 

EDE6 

DO 

07 

. WORD 

$7D0 

; 447 

176 

2711 




; . WORD 

$82B 

; 428 

184 

2712 




i . WORD 

$886 

; 410 

192 

2713 




; . WORD 

$8E1 

; 394 

200 

2714 




; . WORD 

$93C 

; 379 

208 

2715 




; . WORD 

$997 

; 365 

216 

2716 




; . WORD 

$9F2 

; 352 

224 

2717 




; . WORD 

$A4D 

; 339 

232 

2718 




; . WORD 

$AA8 

; 328 

240 

2719 




; . WORD 

$B03 

; 318 

248 


2720 

2721 

2722 

2723 


2724 


■* # ###* # **#*■»#*•«•* ■» •a-*#***# •* •*■***#•***■*■**•****•»*#**#**•*##•»•*•*#•*•**#■«•#** * 


2725 EDE8 


CRNTP3 =* 


2726 #=$14 

2727 0014 02 SIOSPR: .BYTE DSK0RG-CRNTP3 ; ''GSIOL IS TOO LONG 
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2728 

2729 

2730 

2731 

2732 

2733 

2734 

2735 

2736 0002 

2737 OOEA 

2738 

2739 

2740 

2741 

2742 

2743 

2744 0031 

2745 0050 

2746 

2747 

2748 0053 

2749 0021 

2750 0000 

2751 0040 

2752 0080 

2753 

2754 

2755 

2756 

2757 

2758 

2759 E450 4C EA ED 

2760 E453 4C FO ED 

2761 

2762 

2763 

2764 

2765 

2766 

2767 

2768 

2769 

2770 

2771 

2772 

2773 

2774 

2775 

2776 

2777 

2778 

2779 

2780 

2781 


.TITLE 'DISK ***** DISKP. SRC ***** 3/9/79 ***** 4:00:00 P. M. ' 


STATVH = DVSTAT/256 

STATVL = ( -256 ) *ST ATVH+DVST AT ; STATUS POINTER 


CONSTANT EQUATES 


DISKID 

ss 

$31 

SERIAL BUS DISK 

I. D. 

PUTSEC 

= 

$50 

DISK PUT SECTOR 

DCB COMMAND 

i READ 


$52 

DISK GET SECTOR 

DCB COMMAND 

i WRITE 

= 

$57 

DISK PUT SECTOR 

WITH READ CHECK DCB COMMAND 

STATC 

= 

$53 

DISK STATUS DCB 

COMMAND 

FOMAT 

at 

$21 

DISK FORMAT DCB 

COMMAND ! ! ! ! ! ***** 

NODAT 

= 

0 

SIO COMMAND FOR 

"NO DATA" OPERATION 

GETDAT 

= 

$40 

SIO COMMAND FOR 

"DATA FROM DEVICE" 

PUTDAT 

= 

$80 

SIO COMMAND FOR 

"DATA TO DEVICE" 


VECTORS 

*=$E450 

JMP DINIT ; DISK INIT. VECTOR 

UMP DSKIF ; DISK INTERFACE ENTRY POINT 


CONSTANTS 

*=DSKORG 


*********************************************************************** 
DISK INTERFACE ROUTINE STARTS HERE 

*********************************************************************** 
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2782 ; 

2783 ; 

2784 

2785 ; 

2786 ; DISK INTERFACE INITIALIZATION ROUTINE 

2787 j 


2788 

EDEA 

A9 

AO 


DINIT: 

LDA 

#160 

/ 

2789 

EDEC 

8D 

46 

02 


STA 

DSKTIM 

SET INITIAL DISK TIMEOUT TO 160 SEC 

2790 

EDEF 

60 




RTS 



2791 





# 




2792 





; 




2793 





# 




2794 





i 

DISK 

INTERFACE ENTRY 

POINT 

2795 





i 




2796 

EDFO 

A9 

31 


DSKIF: 

LDA 

#DISKID 


2797 

EDF2 

8D 

00 

03 


STA 

DDEVIC 

SET SERIAL BUS I. D IN DCB 

2798 

EDF5 

AD 

46 

02 


LDA 

DSKTIM 


2799 

EDF8 

AE 

02 

03 


LDX 

DCOMND 


2800 

EDFB 

EO 

21 



CPX 

#FOMAT 

IS COMMAND A FORMAT COMMAND? 

2801 

EDFD 

FO 

02 



BEG 

PUTDTO 


2802 

EDFF 

A9 

07 



LDA 

#7 

NO, SET TIMEOUT TO 7 SECS. 

2803 

EE01 

8D 

06 

03 

PUTDTO: 

STA 

DTIMLO 

PUT DISK TIMEOUT IN DCB 

2804 

EE04 

A2 

40 



LDX 

#GETDAT 

SET "GET DATA" COMMAND FOR SIO 

2805 

EE06 

AO 

80 



LDY 

#$80 

SET BYTE COUNT TO 128 

2806 

EE08 

AD 

02 

03 


LDA 

DCOMND 

READ COMMAND IN DCB 

2807 

EEOB 

C9 

57 



CMP 

#WR I TE 

IS COMMAND A "PUT SECTOR" COMMAND? 

2808 

EEOD 

DO 

02 



BNE 

CKSTC 


2809 

EEOF 

A2 

80 



LDX 

#PUTDAT 

YES, SET "PUT DATA" COMMAND FOR SIO 

2810 

EE1 1 

C9 

53 


CKSTC : 

CMP 

#STATC 

IS COMMAND A STATUS COMMAND? 

2811 

EE13 

DO 

OC 



BNE 

PUTCNT 


2812 

EE1 5 

A9 

EA 



LDA 

#STATVL 


2813 

EE 17 

8D 

04 

03 


STA 

DBUFLO 


2814 

EE1A 

A9 

02 



LDA 

#STATVH 


2815 

EE 1C 

8D 

05 

03 


STA 

DBUFHI 

SET BUFFER ADDR TO GLOBAL STATUS BUFFER 

2816 

EE IF 

AO 

04 



LDY 

#4 

YES, SET BYTE COUNT TO 4 

2817 

EE21 

8E 

03 

03 

PUTCNT: 

STX 

DSTATS 

PUT STATUS COMMAND FOR SIO IN DCB 

2818 

EE24 

8C 

08 

03 


STY 

DBYTLO 


2819 

EE27 

A9 

00 



LDA 

#0 


2820 

EE29 

8D 

09 

03 


STA 

DBYTHI 

PUT BYTE COUNT IN DCB 

2821 

EE2C 

20 

59 

E4 


JSR 

SIOV 

CALL SERIAL I/O. 

2822 

EE2F 

10 

01 



BPL 

GOODST 

NO ERROR 

2823 

EE31 

60 




RTS 


NO, GO BACK 

2824 

EE32 

AD 

02 

03 

GOODST: 

LDA 

DCOMND 

READ THE COMMAND 

2825 

EE35 

C9 

53 



CMP 

#STATC 

WAS IT A STATUS COMMAND? 

2826 

EE37 

DO 

OA 



BNE 

PUTBC 


2827 

EE39 

20 

6D 

EE 


JSR 

PUTADR 

PUT BUFFER ADDR IN TEMP REG. 

2828 

EE3C 

AO 

02 



LDY 

#2 


2829 

EE3E 

B 1 

15 



LDA 

< BUFADR > , Y 

READ DISK TIMEOUT VALUE BYTE OF STATUS 

2830 

EE40 

8D 

46 

02 


STA 

DSKTIM 

PUT IT IN DISK TIMEOUT REG. 

2831 

EE43 

AD 

02 

03 

PUTBC : 

LDA 

DCOMND 


2832 

EE46 

C9 

21 



CMP 

#FOMAT 

WAS COMMAND A FORMAT COMMAND? 

2833 

EE48 

DO 

IF 



BNE 

ENDDIF 


2834 

EE4A 

20 

6D 

EE 

FMTD: 

JSR 

PUTADR 

YES, PUT BUFFER ADDR INTO TEMP REG 

2835 

EE4D 

AO 

FE 



LDY 

#$FE 

SET BUFFER POINTER 
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2836 

EE4F 

C8 



TWICE: 

I NY 



2837 

EE50 

C8 




I NY 


; I NCR BUFFER POINTER BY 2 

2838 

EE51 

B1 

15 


RDBAD: 

LDA 

{ BUFADR ) , Y 

; READ LO BYTE BAD SECTOR DATA 

2839 

EE 53 

C9 

FF 



CMP 

#$FF 


2840 

EE55 

DO 

F8 



BNE 

TWICE 

; IS IT "FF" ? 

2841 

EE57 

C8 




INY 


; YES, 

2842 

EE 58 

B 1 

15 



LDA 

(BUFADR), Y 

; READ HI BYTE BAD SECTOR DATA 

2843 

EE 5 A 

C8 




INY 



2844 

EE5B 

C9 

FF 



CMP 

#$FF 


2845 

EE5D 

DO 

F2 



BNE 

RDBAD 

; IS IT "FF" ? 

2846 

EE5F 

88 




DEY 



2847 

EE60 

88 




DEY 


; YES, 

2848 

EE61 

8C 

08 

03 


STY 

DBYTLO 

; PUT BAD SECTOR BYTE COUNT INTO 

2849 

EE64 

A9 

00 



LDA 

#0 


2850 

EE66 

8D 

09 

03 


STA 

DBYTHI 


2851 

EE69 

AC 

03 

03 

ENDDIF: 

LDY 

DSTATS 


2852 

EE6C 

60 




RTS 




2853 

2854 

2855 

2856 

2857 

2858 

2859 

2860 
2861 


SUBROUTINES 

PUT BUFFER ADDR FROM DCB INTO TEMP REG 


2862 

EE6D 

AD 

04 

03 

PUTADR: 

LDA 

DBUFLO 

2863 

EE70 

85 

15 



STA 

BUFADR 

2864 

EE72 

AD 

05 

03 


LDA 

DBUFHI 

2865 

EE75 

85 

16 



STA 

BUFADR+1 ; PUT BUFFER ADDR IN TEMP REG 

2866 

EE77 

60 




RTS 


2867 





; ******* *************** ****** ****** ********* ********* ************ 

2868 

2869 

2870 

2871 






SPARE 

BYTE OR MODULE TOO LONG FLAG 

2872 

2873 

EE78 




CRNTP4 

- 

* 

2874 






*=$14 


2875 

0014 

00 



DSKSPR : 

. BYTE 

PRN0RG-CRNTP4 ; ''GDISKP TOO LONG 


2876 



ERR LINE ADDR 


81 82 B3 84 


DISK ***** DISKP. SRC ***** 3/9/79 ***** 4:00:00 


PAGE 


2877 




. PAGE 



2878 




. TITLE 

'PRINTER ***** PRINTP.SRC ***** 3/9/79 ***** 

2879 

2880 
2881 
2882 

2883 

2884 

2885 

2886 

2887 

2888 
2889 







2890 




DEVICE NUMBER OR CODE EQUATES 

2891 







2892 

0002 


OPNOUT = 

$2 

IOCB OPEN FOR OUTPUT COMMAND 

2893 

0028 


NEUFSZ = 

40 

PRINT NORMAL BUFFER SIZE 

2894 

0014 


DBUFSZ = 

20 

PRINT DOUBLE BUFFFER SIZE 

2895 

001D 


SBUFSZ = 

29 

PRINT SIDEWAYS BUFFER SIZE 

2896 

0040 


PDEVN 

$40 

PRINTER DEVICE NUMBER 

2897 




STATC = 

$53 

DCB STATUS COMMAND CODE 

2898 

0057 


WRITEC = 

$57 

DCB WRITE COMMAND 

2899 

0020 


SPACE 

$20 

ASCII SPACE CHAR. 

2900 

004E 


N 

$4E 

ASCII "N" CHAR. 

2901 

0044 


D 

$44 

ASCII "D” CHAR. 

2902 

2903 

2904 

0053 



3 — 

$53 

ASCII "S" CHAR. 

2905 




PRINTER 

HANDLER ENTRY POINTS 

2906 

2907 

2908 

2909 

2910 

2911 




*=$E430 



2912 

E430 

9E 

EE 

. WORD 

PHOPEN-1 

PRINTER HANDLER OPEN 

2913 

E432 

DB 

EE 

. WORD 

PHCLQS-1 

PH CLOSE 

2914 

E434 

9D 

EE 

. WORD 

BADST-1 

PH READ 

2915 

E436 

A6 

EE 

. WORD 

PHWRIT-1 

PH WRITE 

2916 

E438 

80 

EE 

. WORD 

PHSTAT-1 

PH STATUS 

2917 

E43A 

9D 

EE 

. WORD 

BADST-1 

PH SPECIAL 

2918 

E43C 

4C 

78 EE 

JMP 

PHINIT 

PH INI T. 

2919 

2920 

2921 

2922 

2923 

2924 

E43F 

00 


. BYTE 

0 

ROM FILLER 

2925 




*=PRNORG 


2926 

2927 

2928 

2929 







2930 




PRINTER 

HANDLER INITIALIZATION ROUTINE 


4: 


64 

00: 00 P 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

PRINTER ***** 

PRINTP.SRC ***** 3/9/79 ***** 4:00 PAGE 

2731 





' 





2932 

EE78 

A9 

IE 

PHINIT: 

LDA 

#30 



2933 

EE7A 

85 

1C 



STA 

PTIMOT 


SET UP INITIAL PRINTER TIMEOUT OF 30 

2934 

2935 

2936 

EE7C 

60 




RTS 




2937 






PRINTER 

HANDLER 

CONSTANTS 

2938 










2939 

EE7D 

EA 

02 

PHSTLO: 

. WORD 

DVSTAT 


•STATUS BUFFER POINTER 

2940 

EE7F 

CO 

03 

PHCHLO: 

. WORD 

PRNBUF 


CHAR. BUFFER POINTER 

2941 

2942 

2943 










2944 






************************ 

2945 






PRINTER 

HANDLER 

ROUTINES 

2946 






************************ 

2947 

2948 

2949 

2950 

2951 










2952 






PRINTER 

HANDLER 

STATUS ROUTINE 

2953 










2954 

EE81 

A9 

04 

PHST AT: 

LDA 

#4 



2955 

EE83 

85 

IE 



STA 

PBUFSZ 

; SET BUFFER SIZE TO 4 BYTES 

2956 

EE85 

AE 

7D 

EE 


LDX 

PHSTLO 



2957 

EE88 

AC 

7E 

EE 


LDY 

PHSTLO* 1 

SET POINTER TO STATUS BUFFER 

2958 

EESB 

A9 

53 



LDA 

#STATC 


SET COMMAND TO "STATUS" 

2959 

EE8D 

8D 

02 

03 


STA 

DCOMND 


SET STATUS COMMAND 

2960 

EE90 

8D 

OA 

03 


STA 

DAUX1 



2961 

EE93 

20 

E6 

EE 


JSR 

SETDCB 


GO SETUP DCB 

2962 

EE96 

20 

59 

E4 


JSR 

SIOV 


SEND STATUS COMMAND 

2963 

EE99 

30 

03 



BMI 

BADST 


GO IF ERROR 

2964 

EE9B 

20 

14 

EF 


JSR 

PHPUT 


YES, PUT STATUS INTO GLOBAL BUFFER. 

2965 

EE9E 

60 


BADST: 

RTS 




2966 

2967 

2968 

2969 

2970 

2971 






PRINTER 

HANDLER 

OPEN 

ROUTINE 

2972 

EE9F 

20 

81 

EE PHOPEN: 

JSR 

PHSTAT 


DO STATUS COMMAND TO SIO 

2973 

EEA2 

A9 

00 



LDA 

#0 



2974 

EEA4 

85 

ID 



STA 

PBPNT 


CLEAR PRINT BUFFER POINTER 

2975 

2976 

2977 

2978 

2979 

EEA6 

60 




RTS 




2980 






PRINTER 

HANDLER 

WRITE ROUTINE 

2981 










2982 

EEA7 

85 

IF 

PHWRIT: 

STA 

PTEMP 

; SAVE ACCUM 

2983 

EEA9 

20 

1A 

EF 


JSR 

PRMODE 


GO DETERMINE PRINT MODE 

2984 

EEAC 

A6 

ID 



LDX 

PBPNT 





ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

PRINTER ***** 

PRINTP.SRC ***** 3/9/79 ***** 4:00 

2985 

EEAE 

A5 

IF 



LDA 


PTEMP 

GET CHAR. SENT BY CIO 

2986 

EEBO 

9D 

CO 

03 


STA 


PRNBUFi X 

PUT CHAR. IN PRINT BUFFER 

2987 

EEB3 

E8 




INX 



INCR. BUFFER POINTER 

2988 

EEB4 

E4 

IE 



CPX 


PBUFSZ 

BUFFER POINTER=BUFFER SIZE? 

2989 

EEB6 

FO 

13 



BEG 


BUFFUL 


2990 

EEB8 

86 

ID 



STX 


PBPNT 

SAVE BUFFER POINTER 

2991 

EEBA 

C9 

9B 



CMP 


#CR 

IS CHAR. = EOL ? 

2992 

EEBC 

FO 

03 



BEG 


BLFILL 

IF YES, GO DO BLANK FILL. 

2993 

EEBE 

AO 

01 



LDY 


#SUCCES 

PUT GOOD STATUS IN Y REG FOR 

2994 

EECO 

60 




RTS 




2995 

EEC 1 

A9 

20 

BLFILL: 

LDA 


#SPACE / PUT BLANK IN ACCUM. 

2996 

EEC3 

9D 

CO 

03 

FILLBF : 

STA 


PRNBUF, X 

STORE IT IN PRINT BUFFER. 

2997 

EEC6 

E8 




INX 




2998 

EEC7 

E4 

IE 



CPX 


PBUFSZ 


2999 

EEC9 

DO 

F8 



BNE 


FILLBF 

BUFFER BLANK FILLED? 

3000 

EECB 

A9 

00 

BUFFUL: 

LDA 


#0 


3001 

EECD 

85 

ID 



STA 


PBPNT 

CLEAR PRINT BUFFER POINTER 

3002 

EECF 

AE 

7F 

EE 


LDX 


PHCHLO 


3003 

EED2 

AC 

80 

EE 


LDY 


PHCHLO+1 

SET POINTER TO PRINT BUFFER 

3004 

EED5 

20 

E6 

EE 


JSR 


SETDCB 

GO SETUP DCB 

3005 

EED8 

20 

59 

E4 


JSR 


SIOV 

SEND PRINT COMMAND 

3006 

3007 

3008 

3009 

3010 

EEDB 

60 




RTS 



YES. 

3011 






PRINTER 

HANDLER CLOSE ROUTINE 

3012 










3013 

EEDC 

20 

1A 

EF PHCLOS: 

JSR 


PRMODE 

GO DETERMINE PRINT MODE 

3014 

EEDF 

A6 

ID 



LDX 


PBPNT 


3015 

EEE1 

DO 

DE 



BNE 


BLFILL 


3016 

EEE3 

AO 

01 



LDY 


#SUCCES 


3017 

3018 

3019 

3020 

3021 

3022 

3023 

3024 

3025 

EEE5 

60 




RTS 




3026 






S U 

B R 

0 U T I N E S 

3027 

3028 

3029 

3030 

3031 










3032 






SET 

UP DCS TO CALL SIO 

3033 










3034 

EEE6 

8E 

04 

03 SETDCB : 

STX 


DBUFLO 


3035 

EEE9 

8C 

05 

03 


STY 


DBUFHI ; 

SET BUFFER POINTER 

3036 

EEEC 

A9 

40 



LDA 


#PDEVN 


3037 

EEEE 

8D 

00 

03 


STA 


DDEVIC ; 

SET PRINTER BUS I.D. FOR DCB 

3038 

EEF1 

A9 

01 



LDA 


#1 



66 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 


PRINTER 

a-aaa-a 

PRINTP. SRC 

3/9/79 -a-#*** 4: 00 PAGE 

3039 

EEF3 

8D 

01 

03 



STA 


DUN IT 

/ 

SET UNIT NUMBER TO 1 

3040 

EEF6 

A9 

80 




LDA 


#$80 

i 

DEVICE WILL EXPECT DATA 

3041 

EEF8 

AE 

02 

03 



LDX 


DCOMND 



3042 

EEFB 

EO 

53 




CPX 


#ST ATC 

; 

STATUS COMMAND? 

3043 

EEFD 

DO 

02 




BNE 


PSIOC 



3044 

EEFF 

A9 

40 




LDA 


#$40 

; EXPECT DATA FROM DEVICE 

3045 

EF01 

8D 

03 

03 

PSIOC: 

STA 


DSTATS 

/ 

SET SIO MODE COMMAND. 

3046 

EF04 

A5 

IE 




LDA 


PBUFSZ 



3047 

EF06 

8D 

08 

03 



STA 


DBYTLO 


SET LO BYTE COUNT 

3048 

EF09 

A9 

00 




LDA 


#0 



3049 

EFOB 

8D 

09 

03 



STA 


DBYTHI 

; SET HI BYTE COUNT 

3050 

EFOE 

A5 

1C 




LDA 


PTIMOT 



3051 

EF 10 

8D 

06 

03 



STA 


DTIMLO 


SET DEVICE TIMEOUT COUNT 

3052 

EF13 

60 





RTS 





3053 












3054 












3055 












3056 












3057 






GET DEVICE 

TIMEOUT FROM 

STATUS h. SAVE IT 

3058 












3059 

EF14 

AD 

EC 

02 

PHPUT : 

LDA 


DVSTAT+2 



3060 

EF17 

85 

1C 




STA 


PTIMOT 


SAVE DEVICE TIMEOUT 

3061 

EF 19 

60 





RTS 





3062 












3063 












3064 












3065 












3066 






DETERMINE PRINT MODE & SETUP PRINT BUFFER SIZE, DCB PRINT 

3067 






COMMAND, 

DCB AUX1 FOR 

PRINT MODE 

3068 












3069 

EF1 A 

AO 

57 


PRMODE: 

LDY 


#WR I TEC 

; PUT WRITE COMMAND IN Y REG 

3070 

EF1C 

A5 

2B 




LDA 


ICAX2Z 

iREAD PRINT MODE 

3071 

EF1E 

09 

4E 


CMQDE: 

CMP 


#N 



3072 

EF20 

DO 

04 




BNE 


CDUBL 

; PRINT NORMAL ? 

3073 

EF22 

A2 

28 




LDX 


#NBUFSZ 

; YES, SET NORMAL CHAR. BUFFER SIZE 

3074 

EF24 

DO 

OE 




BNE 


SETBSZ 



3075 

EF26 

09 

44 


CDUBL: 

CMP 


#D 



3076 

EF28 

DO 

04 




BNE 


CSIDE 

; PRINT DOUBLE? 

3077 

EF2A 

A2 

14 




LDX 


#DBUFSZ 

; YES, SET DOUBLE CHAR. BUFFER SIZE 

3078 

EF2C 

DO 

06 




BNE 


SETBSZ 



3079 

EF2E 

09 

53 


CSIDE: 

CMP 


#S 


PRINT SIDEWAYS ? 

3080 

EF30 

DO 

OB 




BNE 


GOERR 


IF NOT, GO TO ERROR ROUTINE 

3081 

EF32 

A2 

ID 




LDX 


#SBUFSZ 


YES, SET SIDEWAYS BUFFER SIZE 

3082 

EF34 

86 

IE 


SETBSZ : 

STX 


PBUFSZ 


STORE PRINT BUFFER SIZE 

3083 

EF36 

8C 

02 

03 



STY 


DCOMND 


STORE DCB COMMAND 

3084 

EF39 

8D 

OA 

03 



STA 


DAUX1 


STORE DCB AUX 1 PRINT MODE 

3085 

EF3C 

60 





RTS 





3086 

EF3D 

A9 

4E 


GOERR: 

LDA 


#N 

; SET DEFAULT PRINT MODE TO NORMAL 

3087 

EF3F 

DO 

DD 




BNE 


CMODE 



3088 






* **•#•**•»■** *■ •a-a-fca-a-a-a-a-a ■a*###'* ■a** aa-aa-a-aa-a’a-a-a-a-aa-aa-a-a-aa-aaa-a-aa-a-a-aa-a-a- a- 

3089 












3090 












3091 






SPARE 

BYTE 

OR 

MODULE TOO LONG FLAG 

3092 













67 



ERR LINE 


ADDR B1 B2 B3 B4 


PRINTER ***** PRINTP. SRC ***** 3/9/79 ***** 4:00 


PAGE 68 


3093 

EF41 

CRNTP5 = 

* 

3094 


i 


3095 


*=$14 


3096 


9 


3097 

0014 00 

PRNSPR : .BYTE 

CASQRG-CRNTP5 * A GPR INTP TOO LONG 

3098 


f 




ERR LINE ADDR B1 B2 B3 B4 


PRINTER ***** PRINTP.SRC ***** 3/9/79 ***** 4:00 


PAGE 69 


3099 

3100 

3101 0003 

3102 00FD 

3103 0040 

3104 0080 

3105 

3106 

3107 

3108 

3109 OOFC 

3110 OOFA 

3111 OOFE 

3112 OOFB 

3113 0002 

3114 0001 

3115 

3116 

3117 

3118 

3119 E440 4B EF 2A FO 

3120 E444 D5 EF OF FO 

3121 E448 27 FO 4A EF 

3122 E44C 4C 41 EF 

3123 E44F 00 

3124 

3125 

3126 

3127 

3128 

3129 

3130 E47A 4C E9 EF 

3131 

3132 

3133 E47D 4C 5D EF 

3134 

3135 

3136 

3137 

3138 

3139 

3140 

3141 EF41 A9 CC 

3142 EF43 8D EE 02 

3143 EF46 A9 05 

3144 EF48 8D EF 02 

3145 

3146 EF4B 60 


. PAGE 

.TITLE 'C ASSET HANDLER 3/12 <DK1:CASCV>' 
CBUFH = CASBUF/256 

CBUFL = ( -256 ) *CBUFH+CASBUF 

SRSTA = $40 ; SIO READ STATUS 

SWSTA = $80 ; SIO WRITE STATUS 

; MQTRGO = $34 

; MOTRST = $3C 


DTA = $FC i DATA RECORD TYPE BYTE 

DTI = $FA ; LAST DATA RECORD 

EOT = $FE i END OF TAPE 

HDR = $FB ; HEADER 

T0NE1 - 2 ; CHANGE TO RECORD MODE TONE 

T0NE2 = 1 ; PRESS PLAY TONE 


*=C ASETV 

. WORD OPENC-1, CLOSEC-1, GBYTE-1, PBYTE-1. STATU-1, SPECIAL-1 


JMP INIT 

.BYTE 0 .ROM FILLER BYTE 


USED IN MON I TP FOR CASSETTE BOOT 

*=RBLOKV 
JMP RBLOK 

*=CSOPIV 
JMP OPINP 


*=CASORG 


; INIT ROUTINE 

i 

INIT: LDA 

STA 
LDA 
STA 

SPECIAL: 

RTS 


#$CC 

CBAUDL 

#$05 

CBAUDH i SET CASSET BAUD RATE TO 600 

; THATS ALL FOLKS 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 CASSET 

HANDLER 

3/12 < DKi : CASCV ) PAGE 70 

3147 





. PAGE 



3148 




t 




3149 




i OPEN 

FUNCTION 

- WITH NO TIMING ADJUST 

3150 




} 




3151 

EF4C 

A5 

2B 

OPENC: 

LDA 

ICAX2Z 

GET AX2 

3152 

EF4E 

85 

3E 


STA 

FTYPE 

SAVE IT FOR FUTURE REFERENCE 

3153 

EF50 

A5 

2A 


LDA 

ICAX1Z 


3154 

EF52 

29 

OC 


AND 

#$0C 

IN AND OUT BITS 

3155 

EF54 

C9 

04 


CMP 

#$04 


3156 

EF56 

F0 

05 


BEQ 

OPINP 


3157 

EF58 

C9 

08 


CMP 

#$08 

SEE IF OPEN FOR OUTPUT 

3158 

EF5A 

FO 

39 


BEQ 

OPOUT 


3159 

EF5C 

60 



RTS 


IF ALREADY OPEN, RETURN LEAVING STATUS=$84 

3160 

EF5D 

A9 

00 

OPINP: 

LDA 

#0 


3161 

EF5F 

8D 

89 

02 

STA 

WMODE 

SET READ MODE 

3162 

EF62 

85 

3F 


STA 

FEOF 

NO EOF YET 

3163 

EF64 

A9 

01 

SFH: 

LDA 

#T0NE2 

TONE FOR PRESS PLAY 

3164 

EF66 

20 

58 

FO 

JSR 

BEEP 

GO BEEP 

3165 

EF69 

30 

24 


BMI 

OPNRTN 

IF ERROR DURING BEEP 

3166 

EF6B 

A9 

34 


LDA 

#MOTRGO 


3167 

EF6D 

8D 

02 

D3 

STA 

PACTL 

TURN MOTOR ON 

3168 





. IF 

PALFLG 


3169 





LDY 

#$E0 


3170 





LDX 

#1 


3171 





. END IF 



3172 





. IF 

PALFLG- 1 


3173 

EF70 

AO 

40 


LDY 

#$40 

5-31-79 9 SEC READ LEADER 

3174 

EF72 

A2 

02 


LDX 

#2 


3175 





. ENDIF 



3176 

EF74 

A9 

03 


LDA 

#3 


3177 

EF76 

8D 

2A 

02 

STA 

CDTMF3 


3178 

EF79 

20 

5C 

E4 

JSR 

SETVBV 

SET UP VBLANK TIMER 

3179 

EF7C 

AD 

2A 

02 WAITTM: 

LDA 

CDTMF3 


3180 

EF7F 

DO 

FB 


BNE 

WAITTM 

WAIT FOR MOTOR TO COME UP TO SPEED 

3181 

EF81 

A9 

80 


LDA 

#$80 

NEXT BYTE=NO BYTES IN BUFFER 

3182 

EF83 

85 

3D 


STA 

BPTR 


3183 

EF85 

8D 

8A 

02 

STA 

BLIM 


3184 

EF88 

4C 

D3 

EF 

JMP 

OPOK 

OPEN OK 

3185 








3186 




; OPEN 

FOR OUTPUT 


3187 








3188 

EF8B 

AO 

80 

PBRK: 

LDY 

#BRKABT 

BREAK KEY ABORT STATUS 

3189 

EF8D 

C6 

11 


DEC 

BRKKEY 

RESET BREAK KEY 

3190 

EF8F 

A9 

00 

OPNRTN: 

LDA 

#0 

CLEAR WRITE MODE FLAG 

3191 

EF91 

8D 

89 

02 

STA 

WMODE 


3192 

EF94 

60 



RTS 


AND EXIT. 

3193 




/ 




3194 

EF95 

A9 

80 

OPOUT: 

LDA 

#$80 


3195 

EF97 

8D 

89 

02 

STA 

WMODE 

SET WRITE MODE 

3196 

EF9A 

A9 

02 


LDA 

#T0NE1 

TELL USER TO TURN ON RECORD MODE 

3197 

EF9C 

20 

58 

FO 

JSR 

BEEP 


3198 

EF9F 

30 

EE 


BMI 

OPNRTN 

IF ERROR DURING BEEP 

3199 

EFA1 

A9 

CC 


LDA 

#$CC 

SET BAUD RATE 

3200 

EFA3 

8D 

04 

D2 

STA 

AUDF3 

WHICH SEEMS TO BE NESSECARY 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

C ASSET HANDLER 

3/12 <DK1: 

CASCV > 

3201 

EFA6 

A9 

05 


LDA 

#$05 

; FOR SOME OBSCURE REASON 

3202 

EFA8 

8D 

06 

D2 

STA 

AUDF4 


3203 

EFAB 

A9 

60 


LDA 

#$60 


3204 

EFAD 

8D 

00 

03 

STA 

DDEVIC 


3205 

EFBO 

20 

68 

E4 

JSR 

SENDEV 

; TELL POKEY TO WRITE MARKS 

3206 

EFB3 

A9 

34 


LDA 

#MOTRGO 

; WRITE 5 SEC BLANK TAPE 

3207 

EFB5 

8D 

02 

D3 

STA 

PACTL 


3208 

EFB8 

A9 

03 


LDA 

#3 


3209 





. IF 

PALFLG 


3210 





LDX 

#$3 


3211 





LDY 

#$C0 


3212 





. END IF 



3213 





. IF 

PALFLG- 1 


3214 

EFBA 

A2 

04 


LDX 

#4 

i 5/30/79 20 SEC LEADER 

3215 

EFBC 

AO 

80 


LDY 

#$80 


3216 





. ENDIF 



3217 

EFBE 

20 

5C 

E4 

JSR 

SETVBV 


3218 

EFC 1 

A9 

FF 


LDA 

#$FF 


3219 

EFC3 

8D 

2A 

02 

STA 

CDTMF3 


3220 

EFC6 

A5 

11 


WDLR: LDA 

BRKKEY 


3221 

EFC8 

FO 

Cl 


BEQ 

PBRK 

i IF BREAK DURING WRITE LEADER 

3222 

EFCA 

AD 

2A 

02 

LDA 

CDTMF3 


3223 

EFCD 

DO 

F7 


BNE 

WDLR 


3224 

EFCF 

A9 

00 


LDA 

#0 

/ INIT BUFFER POINTER 

3225 

EFD1 

85 

3D 


STA 

BPTR 


3226 

EFD3 

AO 

01 


OPOK: LDY 

#SUCCES 


3227 

EFD5 

60 



RTS 




71 



ERR LINE 

ADDR 

B1 

B2 

B3 B4 

CASSET 

HANDLER 

3/12 <DK1:CASCV> PAGE 

3228 






. PAGE 



3229 





t 




3230 





i GET BYTE 



3231 





/ 




3232 

EFD6 

A5 

3F 


GBYTE: 

LDA 

FEOF 

IF AT EOF ALREADY 

3233 

EFD8 

30 

33 



BMI 

ISEOF 

RETURN EOF STATUS 

3234 

EFDA 

A6 

3D 



LDX 

BPTR 

BUFFER POINTER 

3235 

EFDC 

EC 

8A 

02 


CPX 

SLIM 

IF END OF BUFFER 

3236 

EFDF 

FO 

08 



BEQ 

RBLOK 

READ ANOTHER BLOCK 

3237 

EFE1 

BD 

00 

04 


LDA 

CASBUF+3, X 

GET NEXT BYTE 

3238 

EFE4 

E6 

3D 



INC 

BPTR 

BUMP POINTER 

3239 

EFE6 

AO 

01 



LDY 

#SUCCES 

OK STATUS 

3240 

EFE8 

60 



GBX: 

RTS 



3241 

EFE9 

A9 

52 


RBLOK: 

LDA 

#'R 

READ OPCODE 

3242 

EFEB 

20 

95 

FO 


JSR 

SIOSB 

SIO ON SYS BUF 

3243 

EFEE 

98 




TYA 



3244 

EFEF 

30 

F7 



BMI 

GBX 

IF SIO ERRORS, RETURN 

3245 

EFF1 

A9 

00 



LDA 

#0 


3246 

EFF3 

85 

3D 



STA 

BPTR 

RESET POINTER 

3247 

EFF5 

A2 

80 



LDX 

#$80 

DEFAULT # BYTES 

3248 

EFF7 

AD 

FF 

03 


LDA 

CASBUF+2 


3249 

EFFA 

C9 

FE 



CMP 

#EQT 


3250 

EFFC 

FO 

OD 



BEQ 

ATEOF 

IF HEADER, GO READ AGAIN 

3251 

EFFE 

C9 

FA 



CMP 

#DT 1 

IF LAST DATA REC 

3252 

F000 

DO 

03 



BNE 

NLR 


3253 

F002 

AE 

7F 

04 


LDX 

CASBUF+130 

LAST DATA RECORD, GET # BYTES 

3254 

F005 

8E 

8A 

02 

NLR: 

STX 

BLIM 


3255 

F008 

4C 

D6 

EF 


JMP 

GBYTE 

GET NEXT BYTE 

3256 

FOOB 

C6 

3F 


ATEOF: 

DEC 

FEOF 

SET FEOF 

3257 

FOOD 

AO 

88 


ISEOF: 

LDY 

#EOFERR 

ENDFILE STATUS 

3258 

FOOF 

60 




RTS 




72 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

C ASSET HANDLER 

3/12 ( DK1 : CASCV ) 

3259 

3260 





. PAGE 



3261 





; PUT BYTE TO BUFFER 


3262 

3263 

F010 

A6 

3D 


f 

PBYTE: LDX 

BPTR 

BUFFER POINTER 

3264 

F012 

9D 

00 

04 

STA 

CASBUF+3, X 

STORE CHAR AWAY 

3265 

F01 5 

E6 

3D 


INC 

BPTR 

BUMP POINTER 

3266 

F017 

AO 

01 


LDY 

#SUCCES 

OK STATUS 

3267 

F019 

EO 

7F 


CPX 

#127 

IF BUFFER FULL 

3268 

F01B 

FO 

01 


BEQ 

#+3 


3269 

F01D 

60 



RTS 



3270 





; WRITE OUT THE 

BUFFER 


3271 

FOIE 

A9 

FC 


LDA 

#DTA 

RECORD TYPE » DATA 

3272 

F020 

20 

D2 

FO 

JSR 

WSIOSB 

DO WRITE ON SYSTEM BUFFER 

3273 

F023 

A9 

00 


LDA 

#0 


3274 

F025 

85 

3D 


STA 

BPTR 

RESET BUFFER POINTER 

3275 

F027 

60 



RTS 

; EXIT. 


PAGE 



ERR LINE 

ADDR 

Bi 

B2 B3 B4 

C ASSET HANDLER 3/12 (DK1:CASCV) 

3276 




. PAGE 

3277 





3278 




; STATUS - RETURN STATUS INFO THRU DVSTAT 

3279 





3280 

F028 

AO 

01 

STATU: LDY #SUCCES 

3281 

F02A 

60 


RTS 


74 



ERR LINE 

ADDR 

B1 

B2 

B3 B4 

C ASSET 

HANDLER 

3/12 < DK1 : CASCV ) PAGE 75 

3282 






. PAGE 


3283 








3284 





; CLOSE 



3285 





/ 



3286 

F02B 

AD 

89 

02 

CLOSEC: 

LDA 

WMODE ; SEE IF WRITING 

3287 

F02E 

30 

08 



BMI 

CLWRT i GO CLOSE FOR WRITE 

3288 





; CLOSE 

FOR READ - FLAG CLOSED 

3289 

F030 

AO 

01 



LDY 

#SUCCES ; SUCCESSFULL 

3290 

F032 

A9 

3C 


FCAX : 

LDA 

#MOTRST ; STOP THE MOTOR IN CASE WAS SHORT IRG MODE 

3291 

F034 

8D 

02 

D3 


STA 

PACTL 

3292 

F037 

60 




RTS 


3293 

F038 

A6 

3D 


CLWRT : 

LDX 

BPTR ; BUFFER POINTER 

3294 

F03A 

FO 

OA 



BEG 

WTLR i IF NO DATA BYTES IN BUFFER, NO DTI REC 

3295 

F03C 

8E 

7F 

04 


STX 

CASBUF+130 i WRITE TO LAST RECORD 

3296 

F03F 

A9 

FA 



LDA 

#DT1 ;REC TYPE 

3297 

F041 

20 

D2 

FO 


JSR 

WSIOSB i WRITE OUT USER BUFFER 

3298 

F044 

30 

EC 



BMI 

FCAX ; GO IF ERROR 

3299 

F046 

A2 

7F 


WTLR: 

LDX 

#127 i ZERO BUFFER 

3300 

F048 

A9 

00 



LDA 

#0 

3301 

F04A 

9D 

00 

04 

ZTBUF: 

STA 

CASBUF+3, X 

3302 

F04D 

CA 




DEX 


3303 

F04E 

10 

FA 



BPL 

ZTBUF 

3304 

F050 

A9 

FE 



LDA 

#EOT ; WRITE EOT RECORD 

3305 

F052 

20 

D2 

FO 


JSR 

WSIOSB 

3306 

F055 

4C 

32 

FO 


JMP 

FCAX ; FLAG CLOSED AND EXIT 



ERR LINE 

ADDR 

Bl 

B2 

B3 B4 CASSET 

HANDLER 

3/12 (DK1 

CASCV) 

3307 





. PAGE 



3308 








3309 




; SUBROUTINES 



3310 




; 




3311 




; BEEP 

- GENERATE TONE ON 

KEYBOARD SPEAKER 

3312 




; ON ENTRY A= FREQ 


3313 




; 




3314 

F058 

85 

40 

BEEP: 

STA 

FREQ 


3315 

F05A 

A5 

14 

BEEP 1 : 

LDA 

RTCL0K+2 

; CURRENT CLOCK 

3316 

F05C 

18 



CLC 



3317 





. IF 

PALFLG 


3318 





ADC 

#25 


3319 





. ENDIF 



3320 





. IF 

PALFLG- 1 


3321 

F05D 

69 

IE 


ADC 

#30 

; 1 SEC TONE 

3322 





. ENDIF 



3323 

F05F 

AA 



TAX 



3324 

F060 

A9 

FF 

WFL: 

LDA 

#*FF 


3325 

F062 

8D 

IF 

DO 

STA 

CONSOL 

i TURN ON SPEAKER 

3326 

F065 

A9 

00 


LDA 

#0 


3327 

F067 

AO 

FO 


LDY 

#$F0 


3328 

F069 

88 



DEY 



3329 

F06A 

DO 

FD 


BNE 

*-l 


3330 

F06C 

8D 

IF 

DO 

STA 

CONSOL 

; TURN OFF SPEAKER 

3331 

F06F 

AO 

FO 


LDY 

#*F0 


3332 

F071 

88 



DEY 



3333 

F072 

DO 

FD 


BNE 

*-1 


3334 

F074 

E4 

14 


CPX 

RTCLOK+2 

; SEE IF 1 SEC IS UP YET 

3335 

F076 

DO 

E8 


BNE 

WFL 


3336 

F078 

C6 

40 


DEC 

FREQ 

; COUNT BEEPS 

3337 

F07A 

FO 

OB 


BEQ 

WFAK 

; IF ALL DONE GO WAIT FOR KEY 

3338 

F07C 

8A 



TXA 



3339 

F07D 

18 



CLC 



3340 





. IF 

PALFLG 


3341 





ADC 

#8 


3342 





. ENDIF 



3343 





. IF 

PALFLG- 1 


3344 

F07E 

69 

OA 


ADC 

#10 


3345 





. ENDIF 



3346 

F080 

AA 



TAX 



3347 

F081 

E4 

14 


CPX 

RTCLOK+2 


3348 

F083 

DO 

FC 


BNE 

*-2 


3349 

F085 

FO 

D3 


BEQ 

BEEP! 

; UNCOND GO BEEP AGIN 

3350 

F087 

20 

8C 

FO WFAK: 

JSR 

WFAK1 

i USE SIMULATED "JMP (KGETCH) 

3351 

F08A 

98 



TYA 



3352 

F08B 

60 



RTS 



3353 

F08C 

AD 

25 

E4 WFAK1 : 

LDA 

KEYBDV+5 


3354 

F08F 

48 



PHA 


. N 

3355 

F090 

AD 

24 

E4 

LDA 

KEYBDV+4 

i SIMULATE "JMP (KGETCH)" 

3356 

F093 

48 



PHA 



3357 

F094 

60 



RTS 



3358 




; 




3359 




; SIOSB 

- CALL 

SIQ ON SYSTEM BUFFER 

3360 









PAGE 



ERR LINE 

ADDR 

B1 

B2 

B3 B4 

GASSET 

HANDLER 

3/12 (DK1.CASCV) 

3361 

F095 

8D 

02 

03 

SIOSB : 

STA 

DCOMND 

; SAVE COMMAND 

3362 

F098 

A9 

00 



LDA 

#0 


3363 

F09A 

8D 

09 

03 


STA 

DBYTHI 

; SET BUFFER LENGTH 

3364 

F09D 

A9 

83 



LDA 

#131 


3365 

F09F 

8D 

08 

03 


STA 

DBYTLO 


3366 

F0A2 

A9 

03 



LDA 

#CBUFH 


3367 

F0A4 

8D 

05 

03 


STA 

DBUFHI 

; SET BUFFER ADDRESS 

3368 

F0A7 

A9 

FD 



LDA 

#CBUFL 


3369 

F0A9 

8D 

04 

03 


STA 

DBUFLO 


3370 

FOAC 

A9 

60 


CSIO: 

LDA 

#$60 

; C ASSET PSEUDO DEVICE 

3371 

FOAE 

8D 

OO 

03 


STA 

DDEVIC 


3372 

F0B1 

A9 

00 



LDA 

#0 


3373 

F0B3 

8D 

01 

03 


STA 

DUN IT 


3374 

F0B6 

A9 

23 



LDA 

#35 

i DEVICE TIMEOUT (5/30/79) 

3375 

F0B8 

8D 

06 

03 


STA 

DTIMLO 


3376 

FOBB 

AD 

02 

03 


LDA 

DCOMND 

; GET COMMAND BACK 

3377 

FOBE 

AO 

40 



LDY 

#SRSTA 

i SIO READ STATUS COMMAND 

3378 

FOCO 

C9 

52 



CMP 

#'R 


3379 

F0C2 

FO 

02 



BEQ 

*+4 


3380 

F0C4 

AO 

80 



LDY 

#SWSTA 

;SIO WRITE STATUS COMMAND 

3381 

F0C6 

8C 

03 

03 


STY 

DSTATS 

/ SET STATUS FOR SIO 

3382 

F0C9 

A5 

3E 



LDA 

FTYPE 


3383 

FOCB 

8D 

OB 

03 


STA 

DAUX2 

j INDICATE IF SHORT IRG MODE 

3384 

FOCE 

20 

59 

E4 


JSR 

SIOV 

; GO CALL SIO 

3385 

F0D1 

60 




RTS 



3386 





i 




3387 





i WSIOSB - WRITE SIO SYSTEM 

BUFFER 

3388 





i 




3389 

F0D2 

8D 

FF 

03 

WSIOSB: 

STA 

CASBUF+2 

; STORE TYPE BYTE 

3390 

F0D5 

A9 

55 



LDA 

#$55 


3391 

F0D7 

8D 

FD 

03 


STA 

CASBUF+O 


3392 

FODA 

8D 

FE 

03 


STA 

CASBUF+1 


3393 

FODD 

A9 

57 



LDA 

#'W /WRITE 


3394 

FODF 

20 

95 

FO 


JSR 

SIOSB 

; CALL SIO ON SYSTEM BUFFER 

3395 

F0E2 

60 




RTS 

AND 

; RETURN 

3396 

F0E3 




CRNTP6 

=•* 



3397 






*=$14 



3398 

0014 

00 



CASSPR : 

. BYTE 

M0N0RG-CRNTP6 i 'GCASCV IS TOO LONG 


PAGE 



ERR LINE ADDR B1 B2 B3 B4 


C ASSET HANDLER 3/12 <DK1:CASCV> 


PAGE 78 


3399 

3400 .TITLE 'MONITOR ***** MON I TP. SRC ***** 3/9/79 ***** 4:00:00 

3401 

3402 ; 

3403 i 

3404 ; CONSTANT EQUATES 

3405 ; 


3406 

0009 

PUTTXT 

= 

$9 

; "PUT TEXT RECORD" CIO COMMAND CODE 

3407 

0007 

GETCAR 

= 

$7 

; "GET CHARACTER" CIO COMMAND CODE 

3408 

OOOB 

PUTCAR 

= 

$B 

; "PUT CHARACTER" CIO COMMAND CODE 

3409 

0000 

INIMLL 

= 

$00 

; INITIAL MEM LO LOW BYTE 

3410 

0007 

INIMLH 

- 

$07 

; INITIAL MEM LO HIGH BYTE 

3411 


; GOOD 

= 

$1 

; GOOD STATUS CODE 

3412 


; WRITE 

= 

$57 

; WRITE COMMAND 

3413 


; READ 

= 

$52 

; READ COMMAND 

3414 


; STATC 

= 

$53 

; STATUS COMMAND 

3415 

0000 

SEX 

= 

$0 

; SCREEN EDITOR IOCB INDEX 

3416 

007D 

CLS 

= 

$7D 

i CLEAR SCREEN CODE 

3417 

0092 

CTRLC 

= 

$92 

; KEYBOARD CODE FOR 'CONTROL C ' 

3418 

0088 

EOF 

as 

$88 

; CASSETTE END OF FILE CODE 

3419 

3420 

0000 

LIRG 


$0 

; LONG IRG TYPE CODE 

3421 

0004 

BUFFH 

- 

(CASBUF+3) /256 

3422 

0000 

BUFFL 

- 

( -256 ) *BUFFH+CASBUF+3 ; BUFFER POINTER 


3423 

3424 ; 

3425 ; 

3426 i THE FOLLOWING EQUATES ARE IN THE CARTRIDGE ADDRESS SPACE. 

3427 ; 

3428 

3429 ; "B " CARTRIDGE ADDR 'S ARE 8000-9FFF (36K CONFIG. ONLY) 

3430 ; “A" CART. ADDR 'S ARE AOOO-BFFF (36K CONFIG. ONLY) 

3431 > 

3432 ; "A" CART. ADDR 'S ARE BOOO-BFFF (48K CONFIG. ONLY) 

3433 ; 

3434 *=$BFFA 


3435 

BFFA 

CARTCS: 

. RES 

2 

; CARTRIDGE 

COLD START 

ADDRESS. 

3436 

BFFC 

CART: 

. RES 

1 

; CARTRIDGE 

AVAILABLE 

FLAG BYTE. 

3437 

BFFD 

CARTFG: 

. RES 

1 

i CARTRIDGE 

FLAG BYTE. 

BIT 0=FL.AG1 

3438 

BFFE 

CARTAD: 

. RES 

2 

; 2-BYTE CARTRIDGE START VECTOR 


3439 

3440 

3441 

3442 

3443 

3444 

3445 

3446 

3447 

3448 

3449 

3450 

3451 

3452 


CARTRIDGE FLAG ACTION DEFINITIONS 


BIT ACTION IF SET 

7 SPECIAL — DON'T POWER-UP, JUST RUN CARTRIDGE 

6-3 NONE 

2 RUN CARTRIDGE 

1 NONE 

0 BOOT DOS 


P 



MONITOR ***** MONITP. SRC ***** 3/9/79 ***** 4: 00 


PAGE 


79 


ERR LINE ADDR B1 B2 B3 B4 


3453 

3454 

3455 

3456 

3457 

3458 

3459 

3460 

3461 

3462 

3463 

3464 

3465 

3466 

3467 

3468 

3469 

3470 

3471 

3472 

3473 

3474 

3475 

3476 

3477 

3478 

3479 

3480 

3481 

3482 

3483 

3484 

3485 

3486 

3487 

3488 

3489 

3490 

3491 

3492 

3493 

3494 

3495 

3496 

3497 

3498 

3499 

3500 

3501 

3502 

3503 

3504 

3505 

3506 


E471 4C 23 F2 


E474 4C IB FI 


E477 4C 25 FI 


9000 20 OC 90 
9003 4C 25 FI 
9006 20 OC 90 
9009 4C IB FI 


***** 

NOTE 

***** 

1. IF BIT2 IS 0, GOTO BLACKBOARD MODE. 

2. IF BITO SET, THE DISK WILL BE BOOTED BEFORE ANY 
OTHER ACTION. 


POWER-UP VECTOR 

**************************** 

*=$FFFC 

PVECT . WORD PWRUP POWER-UP VECTOR 

************************* 


ENTRY POINT VECTOR 
*=BLKBDV 

JMP SIGNON ; BLACK BOARD VECTOR 

*=WARMSV 

JMP RESET ; WARM START VECTOR 


*=COLDSV 

JMP PWRUP ; COLD START VECTOR <9000 FOR RAM VECTOR WRIT 

*=$9000 

JSR $900C 

JMP PWRUP ; (TO HANDLE RAM VECTOR WRITING) 

JSR $900C 

JMP RESET 


*=MONORG 
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MONITOR ***** MON I TP. SRC ***** 3/9/79 ***** 4:00 


PAGE 80 


3507 




3508 




3509 




3510 

F0E3 

50 


3511 

F0E4 

30 

E4 

3512 

F0E6 

43 


3513 

F0E7 

40 

E4 

3514 

F0E9 

45 


3515 

FOEA 

00 

E4 

3516 

FOEC 

53 


3517 

FOED 

10 

E4 


i HANDLER TABLE ENTRIES 

t 

TBLENT: .BYTE 'P ' 

.WORD PR INTV 
.BYTE 'C' 

. WORD CASETV 
.BYTE 'E' 

.WORD EDITRV 
.BYTE 'S' 

. WORD SCRENV 


3518 FOEF 4B .BYTE 'K' 

3519 FOFO 20 E4 . WORD KEYBDV 

3520 i 

3521 ; 

3522 ; TBLLEN = I DENT- TBLENT- 1 HANDLER TABLE LENGTH. “MOVED TO LINE 8 

3523 ; 

3524 ; ***** PRINT MESSAGES ***** 

3525 

3526 ; 


3527 

F0F2 

7D 

41 

54 

41 

I DENT: . BYTE 

CLS, 'ATARI COMPUTER - MEMO PAD'.. CR 

3528 

F0F6 

52 

49 

20 

43 



3529 

FOFA 

4F 

4D 

50 

55 



3530 

FOFE 

54 

45 

52 

20 



3531 

FI 02 

2D 

20 

4D 

45 


* 

3532 

FI 06 

4D 

4F 

20 

50 



3533 

3534 

F10A 

41 

44 

9B 


i 


3535 

OOFO 





IDENTH = 

IDENT/256 

3536 

00F2 





IDENTL = 

( -256 ) * I DENTH+ 1 DENT > SYSTEM I D. MSG POINTER 

3537 

3538 

OOOE 





j 

TBLLEN = 

I DENT-TBLENT- 1 ; HANDLER TABLE LENGTH 

3539 

F10D 

42 

4F 

4F 

54 

DERRS: . BYTE 

'BOOT ERROR CR 

3540 

Fill 

20 

45 

52 

52 



3541 

FI 15 

4F 

52 

9B 




3542 

3543 

00F1 





/ 

DERRH 

DERR5/256 

3544 

OOOD 





DERRL 

( -256 ) *DERRH+DERR5 ; DISK ERROR MSG POINTER 


3545 ; 

3546 ; 

3547 ; 

3548 i 

3549 ; DEVICE/FILENAME SPECIFICATIONS 

3550 


3551 FI 18 45 3A 9B OPNEDT : .BYTE 'E:',CR ; "OPEN SCREEN EDITOR" DEVICE SPEC. 

3552 ; 


3553 00F1 OPNH = OPNEDT/256 

3554 0018 OPNL =<-256)*0PNH+0PNEDT /SCREEN EDITOR OPEN POINTER 

3555 FI IB 


3556 

3557 

3558 

3559 

3560 


*******************************#•***•»•#*•*■»*•**•*•»-*■***•*##*•#•«• •****#**#■** 



ERR LINE 

ADDR 

B1 

B2 

B3 B4 

MONITOR ***** MON I TP . SRC ****** 3/9/79 ***** 4:00 PAGE 

3561 






RESET 

BUTTON ROUTINE 

STARTS HERE 

3562 





***************************************************************** 

3563 









3564 

FI IB 

78 


RESET: 

SEI 


DISABLE IRQ INTERRUPTS 

3565 

FUC 

AD 

44 

02 


LDA 

COLDST 

WERE WE IN MIDDLE OF COLDSTART? 

3566 

FI IF 

DO 

04 



BNE 

PWRUP 

YES, GO TRY IT AGAIN 

3567 

F121 

A9 

FF 



LDA 

#$FF 


3568 

3569 

3570 

3571 

FI 23 

DO 

03 



BNE 

PWRUP 1 

SET WARM START FLAG 

3572 





*************************************************************** 

3573 






POWER 

UP ROUTINES START HERE 

3574 





**************************************************■*■****•******■»"* 

3575 









3576 

F125 

78 


PWRUP : 

SEI 


DISABLE IRQ INTERRUPTS 

3577 

FI 26 

A9 

00 



LDA 

#0 

CLEAR WARMSTART FLAG 

3578 

FI 28 

85 

08 

PWRUP 1: 

STA 

WARMST 


3579 

F12A 

D8 




CLD 


CLEAR DECIMAL FLAG. 

3580 

F12B 

A2 

FF 



LDX 

#$FF 


3581 

F12D 

9A 




TXS 


SET STACK POINTER 

3582 

F12E 

20 

3F 

F2 


JSR 

SPECL 

CARTRIDGE SPECIAL CASE? 

3583 

FI 31 

20 

77 

F2 


JSR 

HARD I 

DO HARDWARE INITIALIZATION 

3584 

F134 

A5 

08 



LDA 

WARMST 

IS IT WARMSTART? 

3585 

3586 

FI 36 

DO 

28 



BNE 

ZOSRAM 

YES, ONLY ZERO OS RAM 

3587 

FI 38 

A9 

00 

ZERORM: 

LDA 

#0 


3588 

F13A 

AO 

08 



LDY 

#WARMST 


3589 

F13C 

85 

04 



STA 

RAMLO 


3590 

F13E 

85 

05 



STA 

RAMLO+1 

INITIALIZE RAM POINTER 

3591 

F 1 40 

91 

04 

CLRRAM: 

STA 

(RAMLO), Y 

CLEAR MEMORY LOC. 

3592 

FI 42 

C8 




INY 



3593 

F 1 43 

CO 

00 



CPY 

#0 

AT END OF PAGE? 

3594 

F145 

DO 

F9 



BNE 

CLRRAM 


3595 

FI 47 

E6 

05 



INC 

RAMLO+1 

YES, I NCR PAGE POINTER 

3596 

FI 49 

A6 

05 



LDX 

RAMLO+1 


3597 

F14B 

E4 

06 



CPX 

TRAMSZ 

AT END OF MEM? 

3598 

3599 

F14D 

DO 

FI 



BNE 

CLRRAM 

NO. 

3600 





INITIALIZE DOSVEC TO POINT 

TO SIGNON (BLACKBOARD) 

3601 

F14F 

AD 

72 

E4 


LDA 

BLKBDV+1 


3602 

FI 52 

85 

OA 



STA 

DOSVEC 

USE BLACKBOARD VECTOR 

3603 

FI 54 

AD 

73 

E4 


LDA 

BLKBDV+2 

FOR DOSVEC 

3604 

FI 57 

85 

OB 



STA 

DOSVEC +1 


3605 

FI 59 

A9 

FF 



LDA 

#$FF 


3606 

F15B 

8D 

44 

02 


STA 

COLDST 

SET TO SHOW IN MIDDLE OF COLDSTART 

3607 

F15E 

DO 

13 



BNE 

ESTSCM ; GO AROUND ZOSRAM 

3608 









3609 





CLEAR 

OS RAM 

(FOR WARMSTART) 

3610 

FI 60 

A2 

00 

ZOSRAM: 

LDX 

#0 


3611 

FI 62 

8A 




TXA 



3612 

FI 63 

9D 

00 

02 Z0SRM2: 

STA 

$200, X 

CLEAR PAGES 2 AND 3 

3613 

FI 66 

9D 

00 

03 


STA 

$300, X 


3614 

FI 69 

CA 




DEX 




81 
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3615 

F16A 

DO 

F7 



BNE 

Z0SRM2 


3616 

F16C 

A2 

10 



LDX 

#INTZBS 


3617 

F16E 

95 

00 


Z0SRM3: 

STA 

0/ X 

; CLEAR ZERO PAGE. LOCATIONS INTZBS-7F 

3618 

F170 

E8 




INX 



3619 

F171 

10 

FB 



BPL 

Z0SRM3 


3620 









3621 





ESTABLISH SCREEN MARGINS 


3622 

FI 73 

A9 

02 


ESTSCM: 

LDA 

#LEDGE 


3623 

F175 

85 

52 



STA 

LMARGN 


3624 

F 1 77 

A9 

27 



LDA 

#REDGE 


3625 

FI 79 

85 

53 



STA 

RMARGN 


3626 









3627 









3628 





MOVE 

VECTOR 

TABLE FROM ROM 

TO RAM 

3629 

F17B 

A2 

25 


DPSYS: 

LDX 

#$25 


3630 

F17D 

BD 

80 

E4 

iOVVEC 

LDA 

VCTABL, X 

i ROM TABLE 

3631 

FI 80 

9D 

00 

02 


STA 

INTABS, X 

; TO RAM 

3632 

FI 83 

CA 




DEX 



3633 

FI 84 

10 

F7 



BPL 

MOVVEC 


3634 

FI 86 

20 

8A 

F2 


JSR 

OSRAM 

i DO 0. S. RAM SETUP 

3635 

FI 89 

58 




CLI 


; ENABLE IRQ INTERRUPTS 

3636 









3637 









3638 






LINK 

HANDLERS 


3639 









3640 

F18A 

A2 

OE 



LDX 

#TBLLEN 


3641 

F18C 

BD 

E3 

FO 

MXTENT : 

LDA 

TBLENT , X 

; READ HANDLER TABLE ENTRY 

3642 

F18F 

9D 

1A 

03 


STA 

HATABS, X 

; PUT IN TABLE 

3643 

FI 92 

CA 




DEX 



3644 

FI 93 

10 

F7 



BPL 

NX TENT 

; DONE WITH ALL ENTRIES? 

3645 









3646 









3647 









3648 









3649 









3650 





INTERROGATE 

CARTRIDGE ADDR 

. SPACE TO SEE WHICH CARTRIDGES THERE 

3651 









3652 

F195 

A2 

00 



LDX 

#0 


3653 

F 1 97 

86 

07 



STX 

TSTDAT 

; CLEAR "B" CART. FLAG 

3654 

FI 99 

86 

06 



STX 

TRAMSZ 

; CLEAR "A" CART. FLAG 

3655 

F19B 

AE 

E4 

02 


LDX 

RAMSIZ 


3656 

F19E 

EO 

90 



CPX 

#$90 

i RAM IN "B" CART. SLOT? 

3657 

FI AO 

BO 

OA 



BCS 

ENDBCK 


3658 

F1A2 

AD 

FC 

9F 


LDA 

CART-$2000 

i NO, 

3659 

F1A5 

DO 

05 



BNE 

ENDBCK 

i CART. PLUGGED INTO "B" SLOT? 

3660 

F1A7 

E6 

07 



INC 

TSTDAT 

; YES, SET "B" CART. FLAG 

3661 

F1A9 

20 

3C 

F2 


JSR 

CB INI 

i INITIALIZE CARTRIDGE "B" 

3662 









3663 

F 1 AC 

AE 

E4 

02 

ENDBCK: 

LDX 

RAMSIZ 


3664 

FI AF 

EO 

BO 



CPX 

#$B0 

; RAM IN "A" CART. SLOT? 

3665 

F1B1 

BO 

OA 



BCS 

ENDACK 


3666 

F1B3 

AE 

FC 

BF 


LDX 

CART 

; NO, 

3667 

F1B6 

DO 

05 



BNE 

ENDACK 

i CART. PLUGGED INTO "A" SLOT? 

3668 

F1B8 

E6 

06 



INC 

TRAMSZ 

; YES, SET "A" CART. FLAG 
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3669 

FI BA 

20 

39 

F2 


JSR 

CAINI 

INITIALIZE CARTRIDGE "A" 

3670 









3671 





; 




3672 





OPEN SCREEN 

EDITOR 


3673 









3674 

F1BD 

A9 

03 

ENDACK: 

LDA 

#3 


3675 

F1BF 

A2 

OO 



LDX 

#SEX 


3676 

F1C 1 

9D 

42 

03 


STA 

ICCOM, X ;OPEN I/O COMMAND 

3677 

F1C4 

A9 

18 



LDA 

#QPNL 


3678 

F1C6 

9D 

44 

03 


STA 

ICBAL/ X 


3679 

F1C9 

A9 

FI 



LDA 

#OPNH 


3680 

F1CB 

9D 

45 

03 


STA 

ICBAH, X 

SET BUFFER POINTER TO OPEN SCREEN EDITOR 

3681 

F1CE 

A9 

OC 



LDA 

#*C 


3682 

FIDO 

9D 

4A 

03 


STA 

ICAX1/X ? SET UP OPEN FOR INPUT/OUTPUT 

3683 

F1D3 

20 

56 

E4 


JSR 

CIDV ; GO TO CIO 

3684 









3685 

F1D6 

10 

03 



BPL 

SCRNOK 

BR IF NO ERROR 

3686 

F1D8 

4C 

25 

FI 


JMP 

PWRUP 

RETRY PWRUP IF ERROR (SHOULD NEVER HAPPEN!) 

3687 

F1DB 

E8 


SCRNOK:. 

INX 


SCREEN OK, SO WAIT FOR VBLANK TO 

3688 

FIDO 

DO 

FD 



BNE 

SCRNOK 

BRING UP THE DISPLAY 

3689 

FIDE 

C8 




INV 



3690 

F1DF 

10 

FA 



BPL 

SCRNOK 


3691 









3692 









3693 





DO CASSETTE 

BOOT 


3694 

F1E1 

20 

B2 

F3 


JSR 

CSBOOT ; CHECK, BOOT, AND INIT 

3695 









3696 





CHECK 

TO SEE 

IF EITHER CARTRIDGE WANTS DISK BOOT 

3697 

F1E4 

A5 

06 



LDA 

TRAMSZ 

CHECK BOTH CARTRIDGES 

3698 

F1E6 

05 

07 



ORA 

TSTDAT 


3699 

F1E8 

FO 

12 



BEG 

NOCART 

NEITHER CARTRIDGE LIVES 

3700 

F1EA 

A5 

06 



LDA 

TRAMSZ 

"A" CART? 

3701 

FI EC 

FO 

03 



BEG 

N0A1 

NO 

3702 

FI EE 

AD 

FD 

BF 


LDA 

CARTFG 

GET CARTRIDGE MODE FLAG 

3703 

F1F1 

A6 

07 

N0A1 : 

LDX 

TSTDAT 

"B" CART? 

3704 

F1F3 

FO 

03 



BEG 

NOB 1 

NO 

3705 

F1F5 

OD 

FD 

9F 


ORA 

CARTFG-*2000 

; ADD OTHER FLAG 

3706 

F1F8 

29 

01 

NOB 1 : 

AND 

#1 

DOES EITHER CART WANT BOOT? 

3707 

FIFA 

FO 

03 



BEG 

NOBOOT 

NO 

3708 









3709 





DO DISK BOOT 



3710 

FIFO 

20 

CF 

F2 NOCART: 

JSR 

BOOT ; CHECK, BOOT, AND INIT 

3711 









3712 





GO TO 

ONE OF 

THE CARTRIDGES IF THEY SO DESIRE 

3713 

F1FF 

A9 

00 

NOBOOT: 

LDA 

#0 


3714 

F201 

8D 

44 

02 


STA 

COLDST 

RESET TO SHOW DONE WITH COLDST ART 

3715 

F204 

A5 

06 



LDA 

TRAMSZ 

"A” CART? 

3716 

F206 

FO 

OA 



BEG 

N0A2 

NO 

3717 

F208 

AD 

FD 

BF 


LDA 

CARTFG 

GET CARTRIDGE MODE FLAG 

3718 

F20B 

29 

04 



AND 

#4 

DOES IT WANT TO RUN? 

3719 

F20D 

FO 

03 



BEG 

N0A2 

NO 

3720 

F20F 

6C 

FA 

BF 


JMP 

( C ARTCS > 

RUN "A" CARTRIDGE 

3721 

F212 

A5 

07 

N0A2: 

LDA 

TSTDAT 

"B" CART? 

3722 

F214 

FO 

OA 



BEG 

N0CAR2 

NO 
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3723 

F216 

AD 

FD 

9F 


LDA 

CARTFG-*2000 ; GET "B" MODE FLAG 

3724 

F219 

29 

04 



AND 

#4 

; DOES IT WANT TO RUN? 

3725 

F21B 

F0 

DF 



BEG 

NOCART 

; NO 

3726 

F21D 

6C 

FA 

9F 


JMP 

(CARTCS-*2000> ; RUN "B" CARTRIDGE 

3727 





i 




3728 





} NO CARTRIDGES, 

OR NEITHER 

WANTS TO RUN, 

3729 





; SO GO 

TO DOSVEC (DOS, CASSETTE, OR BLACKBOARD) 

3730 

F220 

6C 

OA 

00 

N0CAR2: 

JMP 

(DOSVEC > 


3731 





; 




3732 





; PRINT 

SIGN-ON 

MESSAGE 


3733 

F223 

A2 

F2 


SIGNON: 

LDX 

#IDENTL 


3734 

F225 

AO 

FO 



LDY 

#IDENTH 


3735 

F227 

20 

85 

F3 


JSR 

PUTLIN 

; GO PUT SIGN-ON MSG ON 

3736 





i 




3737 





; 




3738 





i 




3739 





i 

BLACKBOARD ROUTINE 


3740 

F22A 

20 

30 

F2 

BLACKB: 

JSR 

BLKB2 

; "JSR EGETCH" 

3741 

F22D 

4C 

2A 

F2 


JMP 

BLACKB 

; FOREVER 

3742 

F230 

AD 

05 

E4 

BLKB2: 

LDA 

EDITRV+5 

; HIGH BYTE 

3743 

F233 

48 




PHA 



3744 

F234 

AD 

04 

E4 


LDA 

EDI TRV+4 

; LOW BYTE 

3745 

F237 

48 




PHA 



3746 

F238 

60 




RTS 


i SIMULATES "JMP (EDITRV 

3747 





i 




3748 





■, 




3749 





i CARTR 

IDGE INITIALIZATION 

INDIRECT JUMPS 

3750 

F239 

6C 

FE 

BF 

CAINI : 

JMP 

(CARTAD) 


3751 

F23C 

6C 

FE 

9F 

CBINI: 

JMP 

(CART AD-$2000 ) 


PAGE 
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3752 

3753 

3754 

3755 

3756 

3757 

3758 

3759 

3760 

3761 

3762 

3763 

3764 

3765 

3766 

3767 

3768 

3769 

3770 

3771 

3772 

3773 

3774 

3775 

3776 

3777 

3778 

3779 

3780 


. PAGE 


SUBROUT INES 


CHECK FOR HOW MUCH RAM & SPECIAL CARTRIDGE CASE. 

IF SPECIAL CARTRIDGE CASE, DON'T GO BACK — GO TO CART. 


3781 

F23F 

AD 

FC 

BF 

SPECL: 

LDA 

3782 

F242 

DO 

13 



BNE 

3783 

F244 

EE 

FC 

BF 


INC 

3784 

F247 

AD 

FC 

BF 


LDA 

3785 

F24A 

DO 

08 



BNE 

3786 

F24C 

AD 

FD 

BF 


LDA 

3787 

F24F 

10 

03 



BPL 

3788 

F251 

6C 

FE 

BF 


JMP 

3789 





« 


3790 





; CHECK 

FOR 

3791 





/ 


3792 





/ 


3793 

F254 

CE 

FC 

BF 

ENSPEC : 

DEC 

3794 

F257 

AO 

00 


ENSPE2: 

LDY 

3795 

F259 

84 

05 



STY 

3796 

F25B 

A9 

10 



LDA 

3797 

F25D 

85 

06 



STA 

3798 

F25F 

B1 

05 


HOWMCH: 

LDA 

3799 

F261 

49 

FF 



EOR 

3800 

F263 

91 

05 



STA 

3801 

F265 

D1 

05 



CMP 

3802 

F267 

DO 

OD 



BNE 

3803 

F269 

49 

FF 



EOR 

3804 

F26B 

91 

05 



STA 

3805 

F26D 

A5 

06 



LDA 


CART ; CHECK FOR RAM OR CART 

ENSPE2 iGO IF NOTHING OR MAYBE RAM 

CART ;NOW DO RAM CHECK 

CART ; IS IT ROM? 

ENSPEC ; NO 

CARTFG i YES, 

ENSPEC ; BIT SET? 

<CARTAD > i YES, GO RUN CARTRIDGE 

AMOUNT OF RAM 


CART ; RESTORE RAM IF NEEDED 

#0 

RAMLQ+1 

#*10 

TRAMS Z ,• SET RAM POINTER TO 4K. 

(RAMLO+1 ) , Y iREAD RAM LOCATION 
#*FF i INVERT IT. 

(RAMLO+1), Y i WRITE INVERTED DATA. 
(RAMLO+1 ),Y ; READ RAM AGAIN 
ENDRAM 

#*FF > CONVERT IT BACK 

(RAMLO+1 ),Y i RESTORE ORIGINAL RAM DATA 

TRAMSZ 
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3806 

F26F 

18 




CLC 



3807 

F270 

69 

10 



ADC 

#$10 


3808 

F272 

85 

06 



STA 

TRAMSZ 

INCR. RAM POINTER BY 4K. 

3809 

F274 

DO 

E9 



BNE 

HOWMCH 

GO FIND HOW MUCH RAM. 

3810 

F276 

60 



ENDRAM: 

RTS 



3811 





/ 




3812 





i 




3813 





i 




3814 





i 




3815 





$ 

HARDWARE INITIALIZATION 

3816 





$ 




3817 





9 




3818 

F277 

A9 

00 


HARD I: 

LDA 

#0 


3819 

F279 

AA 




TAX 



3820 

F27A 

9D 

00 

DO 

CLRCHP : 

STA 

$D000, X 


3821 

F27D 

9D 

00 

D4 


STA 

$D400, X 


3822 

F280 

9D 

00 

D2 


STA 

$D200, X 


3823 

F283 

9D 

00 

D3 


STA 

$D3G0, X 


3824 

F286 

E8 




INX 



3825 

F287 

DO 

FI 



BNE 

CLRCHP 


3826 

F289 

60 




RTS 



3827 





i 




3828 





# 




3829 





; 

0. S. 

RAM SETUP 


3830 





i 




3831 

F28A 

C6 

11 


OSRAM: 

DEC 

BRKKEY 

TURN OFF BREAK KEY FLAG 

3832 

F28C 

A9 

54 



LDA 

#. LOW. BRKKY2 


3833 

F28E 

8D 

36 

02 


STA 

BRKKY 


3834 

F291 

A9 

E7 



LDA 

#. HIGH. BRKKY2 

3835 

F293 

8D 

37 

02 


STA 

BRKKY+1 


3836 

F296 

A5 

06 



LDA 

TRAMSZ 

READ RAM SIZE IN TEMP. REG. 

3837 

F298 

8D 

E4 

02 


STA 

RAMSIZ 

SAVE IT IN RAM SIZE. 

3838 

F29B 

8D 

E6 

02 


STA 

MEMTOP+1 

INIT. MEMTOP ADDR HI BYTE 

3839 

F29E 

A9 

00 



LDA 

#0 


3840 

F2A0 

8D 

E5 

02 


STA 

MEMTOP 

INIT. MEMTOP ADDR LO BYTE 

3841 

F2A3 

A9 

00 



LDA 

# I N I MLL 


3842 

F2A5 

8D 

E7 

02 


STA 

MEMLO 


3843 

F2A8 

A9 

07 



LDA 

#INIMLH 


3844 

F2AA 

8D 

E8 

02 


STA 

MEMLG+1 

INITIALIZE MEMLO ADDR VECTOR 

3845 

F2AD 

20 

OC 

E4 


JSR 

EDITRV+*C 

EDITOR INIT. 

3846 

F2B0 

20 

1C 

E4 


JSR 

SCRENV+SC 

SCREEN INIT. 

3847 

F2B3 

20 

2C 

E4 


JSR 

KEYBDV+SC 

KEYBOARD INIT. 

3848 

F2B6 

20 

3C 

E4 


JSR 

PRINTV+$C 

PRINTER HANDLER INIT 

3849 

F2B9 

20 

4C 

E4 


JSR 

CASE TV-4- $C 

CASSETTE HANDLER INIT 

3850 

F2BC 

20 

6E 

E4 


JSR 

CIOINV 

CIO INIT. 

3851 

F2BF 

20 

65 

E4 


JSR 

S 10 I NV 

SIO INIT. 

3852 

F2C2 

20 

6B 

E4 


JSR 

INTI NV 

INTERRUPT HANDLER INIT. 

3853 

F2C5 

AD 

IF 

DO 


LDA 

CONSOL 


3854 

F2C8 

29 

01 



AND 

#$1 


3855 

F2CA 

DO 

02 



BNE 

NOKEY ; GAME START KEY DEPRESSED? 

3856 

F2CC 

E6 

4A 



INC 

CKEY ; YES, SET KEY FLAG. 

3857 

F2CE 

60 



NOKEY: 

RTS 




3858 

3859 
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MONITOR 


3860 DO BOOT OF 

3861 ; 


3862 

F2CF 

A5 

08 


BOOT: 

LDA 

3863 

F2D1 

FO 

OA 



BEQ 

3864 

F2D3 

A5 

09 



LDA 

3865 

F2D5 

29 

01 



AND 

3866 

F2D7 

FO 

03 



BEQ 

3867 

F2D9 

20 

7E 

F3 


JSR 

3868 

F2DC 

60 



NO INIT: 

RTS 

3869 

F2DD 

A9 

01 


NOW ARM: 

LDA 

3870 

F2DF 

8D 

01 

03 


STA 

3871 

F2E2 

A9 

53 



LDA 

3872 

F2E4 

8D 

02 

03 


STA 

3873 

F2E7 

20 

53 

E4 


JSR 

3874 

F2EA 

10 

01 



BPL 

3875 

F2EC 

60 




RTS 

3876 







3877 

F2ED 

A9 

00 


DOBOOT: 

LDA 

3878 

F2EF 

8D 

OB 

03 


STA 

3879 

F2F2 

A9 

01 



LDA 

3880 

F2F4 

8D 

OA 

03 


STA 

3881 

F2F7 

A9 

00 



LDA 

3882 

F2F9 

8D 

04 

03 


STA 

3883 

F2FC 

A9 

04 



LDA 

3884 

F2FE 

8D 

05 

03 


STA 

3885 

F301 

20 

9D 

F3 

SECT 1 : 

JSR 

3886 

F304 

10 

08 



BPL 

3887 

F306 

20 

81 

F3 

BADDSK: 

JSR 

3888 

F309 

A5 

4B 



LDA 

3889 

F30B 

FO 

EO 



BEQ 

3890 

F30D 

60 




RTS 

3891 

F30E 

A2 

03 


ALLSEC : 

LDX 

3892 

F310 

BD 

00 

04 

RDBYTE: 

LDA 

3893 

F313 

9D 

40 

02 


STA 

3894 

F316 

CA 




DEX 

3895 

F317 

10 

F7 



BPL 

3896 

F319 

AD 

42 

02 


LDA 

3897 

F31C 

85 

04 



STA 

3898 

F31E 

AD 

43 

02 


LDA 

3899 

F321 

85 

05 



STA 

3900 

F323 

AD 

04 

04 


LDA 

3901 

F326 

85 

OC 



STA 

3902 

F328 

AD 

05 

04 


LDA 

3903 

F32B 

85 

OD 



STA 

3904 

F32D 

AO 

7F 


MVBUFF : 

LDY 

3905 

F32F 

B9 

00 

04 

MVNXB: 

LDA 

3906 

F332 

91 

04 



STA 

3907 

F334 

88 




DEY 

3908 

F335 

10 

F8 



BPL 

3909 

F337 

18 




CLC 

3910 

F338 

A5 

04 



LDA 

3911 

F33A 

69 

80 



ADC 

3912 

F33C 

85 

04 



STA 

3913 

F33E 

A5 

05 



LDA 


MON I TP. SRC ***** 3/9/79 ***** 4:00 
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DISK 

WARMST 

NOWARM » WARM START? 

BOOT? ; YES, 

#1 

NO IN IT i VALID BOOT? 

DINI i YES, RE-INIT. DOS SOFTWARE 

#1 

DUN IT i ASSIGN DISK DRIVE NO. 

#STATC 

DCOMND ; SET UP STATUS COMMAND 

DSKINV > GO DO DISK STATUS 

DOBOOT ; IS STATUS FROM SIO GOOD? 

; NO, GO BACK WITH BAD BOOT STATUS 

#0 

DAUX2 

#1 

DAUX1 i SET SECTOR # TO 1. 

#BUFFL 

DBUFLO 

#BUFFH 

DBUFHI i SET UP BUFFER ADDR 

GETSEC ; GET SECTOR 

ALLSEC ; STATUS 0. K. ? 

DSKRDE i NO, GO PRINT DISK READ ERROR 

CASSBT 

DOBOOT ; CASSETTE BOOT? 

; YES, QUIT 
#3 

CASBUF+3, X ; READ A BUFFER BYTE 

DFLAGS, X ; STORE IT 

RDBYTE ; DONE WITH 4 BYTE TRANSFER ? 

BOOTAD ; YES, 

RAMLO 

BOOTAD+1 

RAMLO+1 i PUT BOOT ADDR INTO Z. PAGE RAM 

CASBUF+7 

DOSINI ; ESTABLISH DOS INIT ADDRESS 

CASBUF+8 

DOS I N I + 1 

#*7F ; YES, SET BYTE COUNT 

CASBUF+3, Y 

(RAMLO), Y ;MOVE A BYTE FROM SECTOR BUFFER TO BOOT ADDR 

MVNXB ; DONE ? 

i YES, 

RAMLO 

#$80 

RAMLO 

RAMLO+1 
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ADDR 

El 

B2 

B3 B4 
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3914 

F340 

69 

00 




ADC 

#0 


3915 

F342 

85 

05 




STA 

RAMLQ+1 

I NCR BOOT LOADER BUFFER POINTER. 

3916 

F344 

CE 

41 

02 



DEC 

DBSECT 

DECR # OF SECTORS. 

3917 

F347 

F0 

11 




BEQ 

ENBOOT 

MORE SECTORS ? 

3918 

F349 

EE 

OA 

03 



INC 

DAUX1 

YES, I NCR SECTOR # 

3919 

F34C 

20 

9D 

F3 

SECTX : 

JSR 

GETSEC 

GO GET SECTOR. 

3920 

F34F 

10 

DC 




BPL 

MVBUFF 

STATUS 0. K. ? 

3921 

F351 

20 

81 

F3 



JSR 

DSKRDE 

NO, GO PRINT DISK READ ERROR 

3922 

F354 

A5 

4B 




LDA 

C ASSET 


3923 

F356 

DO 

AE 




BNE 

BADDSK 

IF CASSETTE, QUIT. 

3924 

F358 

FO 

F2 




BEQ 

SECTX 

IF DISK, TRY SECTOR AGAIN. 

3925 

F35A 

A5 

4B 


ENBQOT 

: LDA 

C ASSET 


3926 

F35C 

FO 

03 




BEQ 

XBOOT 

CASSETTE BOOT ? 

3927 

F35E 

20 

9D 

F3 



JSR 

GETSEC 

YES, GET EOF RECORD, BUT DON'T USE IT 

3928 

F361 

20 

6C 

F3 

XBOOT : 

JSR 

BLOAD 

GO EXECUTE BOOT LOADER 

3929 

F364 

BO 

AO 




BCS 

BADDSK 

IF BAD BOOT, DO IT OVER AGAIN 

3930 

F366 

20 

7E 

F3 



JSR 

DINI 

GO INI T. SOFTWARE 

3931 

F369 

E6 

09 




INC 

BOOT? 

SHOW BOOT SUCCESS 

3932 

F36B 

60 





RTS 



3933 

F36C 

18 



BLOAD: 

CLC 



3934 

F36D 

AD 

42 

02 



LDA 

BOOTAD 


3935 

F370 

69 

06 




ADC 

#6 


3936 

F372 

85 

04 




STA 

RAMLO 


3937 

F374 

AD 

43 

02 



LDA 

BGOTAD+1 


3938 

F377 

69 

00 




ADC 

#0 


3939 

F379 

85 

05 




STA 

RAMLO+1 

PUT START ADDR OF BOOTLOADER INTO RAM 

3940 

F37B 

6C 

04 

00 



JMP 

(RAMLO) 


3941 

F37E 

6C 

OC 

00 

DINI: 

JMP 

( DOS INI > 


3942 










3943 










3944 










3945 










3946 






DISPLAY DISK 

READ ERROR MSG 

3947 










3948 

F381 

A2 

OD 


DSKRDE 

: LDX 

#DERRL 


3949 

F383 

AO 

FI 




LDY 

#DERRH 


3950 










3951 










3952 










3953 






PUT 

LINE ON SCREEN AT PRESENT CURSOR POSITION 

3954 










3955 






x- 

REG — LO 

BYTE, BEGIN 

ADDR OF LINE 

3956 






Y- 

REG — HI 

BYTE, BEGIN 

ADDR OF LINE 

3957 










3958 

F385 

8A 



PUTLIN 

: TXA 



3959 

F386 

A2 

00 




LDX 

#SEX 


3960 

F388 

9D 

44 

03 



STA 

ICBAL, X 


3961 

F38B 

98 





TYA 



3962 

F38C 

9D 

45 

03 



STA 

ICBAH, X 

; SET UP ADDR OF BEGIN OF LINE 

3963 

F38F 

A9 

09 




LDA 

#PUTTXT 


3964 

F391 

9D 

42 

03 



STA 

ICCOM, X 

i "PUT TEXT RECORD" COMMAND 

3965 

F394 

A9 

FF 




LDA 

#*FF 


3966 

F396 

9D 

48 

03 



STA 

ICBLL, X 

; SET BUFFER LENGTH 

3967 

F399 

20 

56 

E4 



JSR 

CIOV 

» PUT LINE ON SCREEN 
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3968 

F39C 

60 




RTS 



3969 









3970 









3971 









3972 









3973 





GET SECTOR 

FROM DISK 0 


3974 









3975 

F39D 

A5 

4B 


SETSEC: 

LDA 

CASSBT 


3976 

F39F 

FO 

03 



BEG 

DISKM 

CASSETTE BOOT ? 

3977 

F3A1 

4C 

7A 

E4 


JMP 

RBLQKV 

YES, GO TO READ BLOCK ROUTINE 

3978 

F3A4 

A9 

52 


DISKM: 

LDA 

#READ 


3979 

F3A6 

8D 

02 

03 


STA 

DCOMND 

SET READ SECTOR COMMAND 

3980 

F3A9 

A9 

01 



LDA 

#1 


3981 

F3AB 

8D 

01 

03 


STA 

DUN IT 

SET DRIVE NO. TO DRIVE 0 

3982 

F3AE 

20 

53 

E4 


JSR 

DSKINV 

GET SECTOR 

3983 

F3B1 

60 




RTS 



3984 









3985 









3986 









3987 





DO CHECK FOR CASSETTE BOOT 

& IF SO, DO BOOT 

3988 









3989 

F3B2 

A5 

08 


DSBOQT : 

LDA 

WARMST 

WARMST ART? 

3990 

F3B4 

FO 

OA 



BEG 

CSB0T2 

NO 

3991 

F3B6 

A5 

09 



LDA 

BOOT? 

GET BOOT FLAG 

3992 

F3B8 

29 

02 



AND 

#2 

WAS CASSETTE BOOT SUCCESFULL? 

3993 

F3BA 

FO 

03 



BEG 

N0CSB2 

NO 

3994 

F3BC 

20 

El 

F3 


JSR 

C INI 

YES, INIT CASSETTE SOFTWARE 

3995 

F3BF 

60 



M0CSB2: 

RTS 



3996 









3997 

F3C0 

A5 

4A 


:SB0T2: 

LDA 

CKEY 


3998 

F3C2 

FO 

1C 



BEG 

NOCSBT 

"C" KEY FLAG SET ? 

3999 

F3C4 

A9 

80 



LDA 

#$80 

YES, 

4000 

F3C6 

85 

3E 



STA 

FTYPE 

SET LONG IRG TYPE 

4001 

F3C8 

E6 

4B 



INC 

CASSBT 

SET CASSETTE BOOT FLAG 

4002 

F3CA 

20 

7D 

E4 


JSR 

CSOPIV 

OPEN CASSETTE FOR INPUT 

4003 

F3CD 

20 

01 

F3 


JSR 

SECT1 

DO BOOT & INIT. 

4004 

F3D0 

A9 

00 



LDA 

#0 


4005 

F3D2 

85 

4B 



STA 

CASSBT 

RESET CASSETTE BOOT FLAG 

4006 

F3D4 

85 

4A 



STA 

CKEY 

CLEAR KEY FLAG 

4007 

F3D6 

06 

09 



ASL 

BOOT? 

SHIFT BOOT FLAG <N0W=2 IF SUCCESS) 

4008 

F3D8 

A5 

OC 



LDA 

DOS INI 


4009 

F3DA 

85 

02 



STA 

CASINI 

MOVE INIT ADDRESS FOR CASSETTE 

4010 

F3DC 

A5 

OD 



LDA 

DQSINI+1 


4011 

F3DE 

85 

03 



STA 

CASINI+1 


4012 

F3E0 

60 


f 

<40CSBT : 

RTS 



4013 









4014 

F3E1 

6C 

02 

00 

2 INI : 

JMP 

(CASINI) 

INIT CASSETTE 

4015 





************************»********************************************** 

4016 









4017 









4018 





SPARE 

BYTE 

OR MODULE TOO LONG FLAG 

4019 









4020 

F3E4 



( 

:RNTP7 

=* 



4021 
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MONSPR : 


*=$14 

. BYTE KBD0RG-CRNTP7 ; ''GMONITP TOO LONG 


4022 

4023 

4024 


0014 00 
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4025 



. PAGE 





4026 



. TITLE 

'DISPLAY HANDLER - 

- 10-30-78 — 

DISPLC 

4027 


/ 






4028 


i HANDLER DEPENDENT EQUATES 




4029 

4030 

007D 

# 

CLRCOD 

js- 

$7D 

; CLEAR 

SCREEN AT ASCI 

CODE 

4031 

4032 

009F 

CNTL1 

=S 

*9F 

} POKEY 

KEY CODE FOR 

~1 

4033 

0068 

FRMADR 

= 

SAVADR 




4034 

4035 

0066 

TOADR 


MLTTMP 






ERR LINE 

ADDR 

B 1 

B2 

B3 B4 DISPLAY HANDLER 

— 10-30-78 -- DISPLC PAGE 

4036 




. PAGE 



4037 




/ 



4038 




; 



4039 




*=EDITRV 


4040 




i 



4041 




i SCREEN EDITOR 

HANDLER 

ENTRY POINT 

4042 




i 



4043 

E400 

FB 

F3 

EDITOR: .WORD 

EOPEN-1 


4044 

E402 

33 

F6 

. WORD 

RETUR1-1 

i < CLOSE) 

4045 

E404 

3D 

F6 

. WORD 

EGETCH-1 


4046 

E406 

A3 

F6 

. WORD 

EOUTCH-1 


4047 

E408 

33 

F6 

. WORD 

RETUR1-1 

; (STATUS) 

4048 

E40A 

3C 

F6 

. WORD 

NOFUNC-1 

; (SPECIAL) 

4049 

E40C 

4C 

E4 

F3 JMP 

PWRONA 


4050 

E40F 

00 


. BYTE 

0 

; ROM FILLER BYTE 

4051 




i 



4052 




*=SCRENV 


4053 




i 



4054 




i DISPLAY HANDLER ENTRY 

POINT 

4055 




i 



4056 

E410 

F5 

F3 

DISPLA: . WORD 

DQPEN-1 


4057 

E412 

33 

F6 

. WORD 

RETUR1-1 

; (CLOSE) 

4058 

E414 

92 

F5 

. WORD 

GETCH-1 


4059 

E416 

B6 

F5 

. WORD 

OUTCH-1 


4060 

E418 

33 

F6 

. WORD 

RETUR1-1 

; (STATUS) 

4061 

E41 A 

FB 

FC 

. WORD 

DRAW-1 

; (SPECIAL) 

4062 

E41C 

4C 

E4 

F3 JMP 

PWRONA 


4063 

E41F 

00 


. BYTE 

0 

i ROM FILLER BYTE 

4064 




I 



4065 




*=KEYBDV 


4066 




/ 



4067 




1 



4068 




i KEYBOARD HANDLER ENTRY 

POINT 

4069 




/ 



4070 

E420 

33 

F6 

KBDHND: . WORD 

RETUR1-1 


4071 

E422 

33 

F6 

. WORD 

RETUR1-1 

; (CLOSE) 

4072 

E424 

El 

F6 

. WORD 

KGETCH-1 


4073 

E426 

3C 

F6 

. WORD 

NOFUNC-1 

; (OUTCH) 

4074 

E428 

33 

F6 

. WORD 

RETUR1-1 

i (STATUS) 

4075 

E42A 

3C 

F6 

. WORD 

NOFUNC-1 

; (SPECIAL) 

4076 

E42C 

4C 

E4 

F3 JMP 

PWRONA 


4077 

E42F 

00 


. BYTE 

0 

; ROM FILLER BYTE 

4078 




i 



4079 




i 



4080 




} INTERRUPT VECTOR TABLE 

ENTRY 

4081 




*=VCTABL- INTABS+VKEYBD 

4082 

E488 

BE 

FF 

. WORD 

PIRG5 

; KEYBOARD IRQ INTERRUPT VECTOR 


92 
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4083 









4084 





*=KBDORG 



4085 





i 




4086 

F3E4 

A9 

FF 


PWRONA: LDA 

#$FF 



4087 

F3E6 

8D 

FC 

02 

STA 

CH 



4088 

F3E9 

AO 

E6 

02 

LDA 

MEMTOP+1 



4089 

F3EC 

29 

FO 


AND 

#$F0 

> INSURE 4K PAGE BOUNDARY 


4090 

F3EE 

85 

6A 


STA 

RAMTQP 



4091 

F3F0 

A9 

40 


LDA 

#$40 

i DEFAULT- TQ UPPER CASE ALPHA AT 

PWRON 

4092 

F3F2 

8D 

BE 

02 

STA 

SHFLOK 



4093 

F3F5 

60 



RTS 


i POWER ON COMPLETED 




ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

DISPLAY HANDLER — 10-: 

4094 






. PAGE 


4095 





j 



4096 





; 



4097 





; BEGIN 

DISPLAY 

HANDLER i 

4098 





; 



4099 

F3F6 

A5 

2B 


DOPEN: 

LDA 

ICAX2Z 

4100 

F3F8 

29 

OF 



AND 

#*F 

4101 

F3FA 

DO 

08 



BNE 

OPNCOM 

4102 

F3FC 

A5 

2A 


EOPEN: 

LDA 

ICAX1Z 

4103 

F3FE 

29 

OF 



AND 

#*F 

4104 

F400 

85 

2A 



STA 

ICAX1Z 

4105 

F402 

A9 

00 



LDA 

#0 

4106 

F404 

85 

57 


OPNCOM: 

STA 

D INDEX 

4107 

F406 

A9 

EO 



LDA 

#*E0 

4108 

F408 

8D 

F4 

02 


STA 

CHBAS 

4109 

F40B 

A9 

02 



LDA 

#2 

4110 

F40D 

8D 

F3 

02 


STA 

CHACT 

4111 

F410 

8D 

2F 

02 


STA 

SDMCTL 

4112 

F413 

A9 

01 



LDA 

#SUCCES 

4113 

F415 

85 

4C 



STA 

DSTAT 

4114 

F417 

A9 

CO 



LDA 

#$C0 

4115 

F419 

05 

10 



ORA 

POKMSK 

4116 

F41B 

85 

10 



STA 

POKMSK 

4117 

F41D 

8D 

OE 

D2 


STA 

IRGEN 

4118 

F420 

A9 

00 



LDA 

#0 

4119 

F422 

8D 

93 

02 


STA 

TINDEX 

4120 

F425 

85 

64 



STA 

ADRESS 

4121 

F427 

85 

7B 



STA 

SWPFLG 

4122 

F429 

8D 

FO 

02 


STA 

CRSINH 

4123 

F42C 

AO 

OE 



LDY 

#14 

4124 

F42E 

A9 

01 



LDA 

#1 

4125 

F430 

99 

A3 

02 

CLRTBS: 

STA 

TABMAP, Y 

4126 

F433 

88 




DEY 


4127 

F434 

10 

FA 



BPL 

CLRTBS 

4128 

F436 

A2 

04 



LDX 

#4 

4129 

F438 

BD 

Cl 

FE 

D0PEN8: 

LDA 

COLRTB, X 

4130 

F43B 

9D 

C4 

02 


STA 

COLORO, X 

4131 

F43E 

CA 




DEX 


4132 

F43F 

10 

F7 



BPL 

D0PEN8 

4133 

F441 

A4 

6A 



LDY 

RAMTOP 

4134 

F443 

88 




DEY 


4135 

F444 

8C 

95 

02 


STY 

TXTMSC+1 

4136 

F447 

A9 

60 



LDA 

#*60 

4137 

F449 

8D 

94 

02 


STA 

TXTMSC 

4138 

F44C 

A6 

57 



LDX 

DINDEX 

4139 

F44E 

BD 

69 

FE 


LDA 

ANCONV, X 

4140 

F451 

DO 

04 



BNE 

DOPENA 

4141 

F453 

A9 

91 


QPNERR: 

LDA 

#BADMOD 

4142 

F455 

85 

4C 



STA 

DSTAT 

4143 

F457 

85 

51 


DOPENA: 

STA 

H0LD1 

4144 

F459 

A5 

6A 



LDA 

RAMTOP 

4145 

F45B 

85 

65 



STA 

ADRESS+1 

4146 

F45D 

BC 

45 

FE 


LDY 

ALOCAT, X 

4147 

F460 

A9 

28 


DOPEN 1: 

LDA 

#40 


78 


DISPLC 
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I PROCESSING 

i GET AUX 2 BYTE 

; IF MODE ZERO, CLEAR ICAX1Z 
; CLEAR "CLR INHIBIT" AND "MXD MODE" BITS 

; INITIALIZE GLOBAL VBLANK RAM 

i TURN OFF DMA NEXT VBLANK 

; CLEAR STATUS 
; DO IRGEN 

; TEXT INDEX MUST ALWAYS BE 0 

i TURN CURSOR ON AT OPEN 
; CLEAR TAB STOPS 

! INIT TAB STOPS TO EVERY 8 CHARACTERS 

iLOAD COLOR REGISTERS 

; DO TXTMSC=*2C40 < IF MEMTOP=3000> 


i CONVERT IT TO ANTIC CODE 
i IF ZERO, IT IS ILLEGAL 
i SET ERROR STATUS 

i SET UP AN INDIRECT POINTER 
; ALLOCATE N BLOCKS OF 40 BYTES 
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4148 

F462 

20 

21 

F9 


JSR 

DBSUB 


4149 

F465 

88 




DEY 



4150 

F466 

DO 

F8 



BNE 

D0PEN1 


4151 

F468 

AD 

6F 

02 


LDA 

GPRIOR 

CLEAR GTI A MODES 

4152 

F46B 

29 

3F 



AND 

#$3F 


4153 

F46D 

85 

67 



STA 

OPNTMP+1 


4154 

F46F 

A8 




TAY 



4155 

F470 

EO 

08 



CPX 

#8 

TEST IF 320X1 

4156 

F472 

90 

17 



BCC 

N0T8 


4157 

F474 

8A 




TXA 

» GET 2 LOW BITS 

4158 

F475 

6A 




ROR 

A 


4159 

F476 

6A 




ROR 

A 


4160 

F477 

6A 




ROR 

A 


4161 

F478 

29 

CO 



AND 

#$C0 

NOW 2 TOP BITS 

4162 

F47A 

05 

67 



ORA 

OPNTMP+1 


4163 

F47C 

A8 




TAY 



4164 

F47D 

A9 

10 



LDA 

#16 

SUBTRACT 16 MORE FOR PAGE BOUNDARY 

4165 

F47F 

20 

21 

F9 


JSR 

DBSUB 


4166 

F482 

EO 

OB 



CPX 

#11 

TEST MODE 11 

4167 

F484 

DO 

05 



BNE 

N0T8 

IF MODE = 11 

4168 

F486 

A9 

06 



LDA 

#6 

PUT GTIA LUM VALUE INTO BACKGROUND REGISTER 

4169 

F488 

8D 

C8 

02 


STA 

C0L0R4 


4170 

F48B 

8C 

6F 

02 

N0T8: 

STY 

GPRIOR 

STORE NEW PRIORITY 

4171 

F48E 

A5 

64 



LDA 

ADRESS 

SAVE MEMORY SCAN COUNTER ADDRESS 

4172 

F490 

85 

58 



STA 

SAVMSC 


4173 

F492 

A5 

65 



LDA 

ADRESS+i 


4174 

F494 

85 

59 



STA 

SAVMSC +1 


4175 

F496 

AD 

OB 

D4 

VBWAIT : 

LDA 

VCOUNT ; WAIT FOR NEXT VBLANK BEFORE MESSING 

4176 

F499 

C9 

7A 



CMP 

#$7A 

WITH THE DISPLAY LIST 

4177 

F49B 

DO 

F9 



BNE 

VBWAIT 


4178 

F49D 

20 

IF 

F9 


JSR 

DBDEC 

START PUTTING DISPLAY LIST RIGHT UNDER RAM 

4179 

F4A0 

BD 

75 

FE 


LDA 

PAGETB, X 

TEST IF DISPLAY LIST WILL BE IN TROUBLE 

4180 

F4A3 

FO 

06 



BEG 

NOMOD 

OF CROSSING A 256 BYTE PAGE BOUNDARY 

4181 

F4A5 

A9 

FF 



LDA 

#$FF 

IF SO. DROP DOWN A PAGE 

4182 

F4A7 

85 

64 



STA 

ADRESS 


4183 

F4A9 

C6 

65 



DEC 

ADRESS+1 


4184 

F4AB 

A5 

64 


NOMOD: 

LDA 

ADRESS 

SAVE END OF DISPLAY LIST FOR LATER 

4185 

F4AD 

85 

68 



STA 

SAVADR 


4186 

F4AF 

A5 

65 



LDA 

ADRESS+1 


4187 

F4B1 

85 

69 



STA 

SAVADR-*- 1 


4188 

F4B3 

20 

13 

F9 


JSR 

DBDDEC 

(DOUBLE BYTE DOUBLE DECREMENT) 

4189 

F4B6 

A9 

41 



LDA 

#$41 

(ANTIC) WAIT FOR VBLANK AND JMP TO TOP 

4190 

F4B8 

20 

17 

F9 


JSR 

STORE 


4191 

F4BB 

86 

66 



STX 

OPNTMP 


4192 

F4BD 

A9 

18 



LDA 

#24 

INITIALIZE BOTSCR 

4193 

F4BF 

8D 

BF 

02 


STA 

BOTSCR 


4194 

F4C2 

A5 

57 



LDA 

DINDEX 

DISALLOW MIXED MODE IF MODE. GE. 9 

4195 

F4C4 

C9 

09 



CMP 

#9 


4196 

F4C6 

BO 

2D 



BCS 

NOTMXD 


4197 

F4C8 

A5 

2A 



LDA 

ICAX1Z 

TEST MIXED MODE 

4198 

F4CA 

29 

10 



AND 

#$10 


4199 

F4CC 

FO 

27 



BEG 

NOTMXD 


4200 

F4CE 

A9 

04 



LDA 

#4 


4201 

F4D0 

8D 

BF 

02 


STA 

BOTSCR 




LINE 

ADDR 

B 1 

B2 

B3 B4 

DISPLAY HANDLER 

4202 

F4D3 

A2 

02 



LDX 

4203 

F4D5 

A9 

02 


D0PEN2: 

LDA 

4204 

F4D7 

20 

17 

F9 


JSR 

4205 

F4DA 

CA 




DEX 

4206 

F4DB 

10 

F8 



BPL 

4207 

F4DD 

A4 

6A 



LDY 

4208 

F4DF 

88 




DEY 

4209 

F4E0 

98 




TYA 

4210 

F4E1 

20 

17 

F9 


JSR 

4211 

F4E4 

A9 

60 



LDA 

4212 

F4E6 

20 

17 

F9 


JSR 

4213 

F4E9 

A9 

42 



LDA 

4214 

F4EB 

20 

17 

F9 


JSR 

4215 

F4EE 

18 




CLC 

4216 

F4EF 

A9 

OC 



LDA 

4217 

F4F1 

65 

66 



ADC 

4218 

F4F3 

85 

66 



STA 

4219 

F4F5 

A4 

66 


NOTMXD: 

LDY 

4220 

F4F7 

BE 

51 

FE 


LDX 

4221 

F4FA 

A5 

51 


D0PEN3: 

LDA 

4222 

F4FC 

20 

17 

F9 


JSR 

4223 

F4FF 

CA 




DEX 

4224 

F500 

DO 

F8 



BNE 

4225 

F502 

A5 

57 



LDA 

4226 

F504 

C9 

08 



CMP 

4227 

F506 

90 

1C 



BCC 

4228 

F508 

A2 

5D 



LDX 

4229 

F50A 

A5 

6A 



LDA 

4230 

F50C 

38 




SEC 

4231 

F50D 

E9 

10 



SBC 

4232 

F50F 

20 

17 

F9 


JSR 

4233 

F512 

A9 

00 



LDA 

4234 

F514 

20 

17 

F9 


JSR 

4235 

F517 

A9 

4F 



LDA 

4236 

F519 

20 

17 

F9 


JSR 

4237 

F51C 

A5 

51 


D0PEN4: 

LDA 

4238 

F51E 

20 

17 

F9 


JSR 

4239 

F521 

CA 




DEX 

4240 

F522 

DO 

F8 



BNE 

4241 

F524 

A5 

59 


D0PEN5: 

LDA 

4242 

F526 

20 

17 

F9 


JSR 

4243 

F529 

A5 

58 



LDA 

4244 

F52B 

20 

17 

F9 


JSR 

4245 

F52E 

A5 

51 



LDA 

4246 

F530 

09 

40 



ORA 

4247 

F532 

20 

17 

F9 


JSR 

4248 

F535 

A9 

70 



LDA 

4249 

F537 

20 

17 

F9 


JSR 

4250 

F53A 

A9 

70 



LDA 

4251 

F53C 

20 

17 

F9 


JSR 

4252 

F53F 

A5 

64 



LDA 

4253 

F541 

8D 

30 

02 


STA 

4254 

F544 

A5 

65 



LDA 

4255 

F546 

8D 

31 

02 


STA 


— 10-30-78 — DISPLC PAGE 96 

#2 ; ADD 4 LINES OF TEXT AT BOTTOM OF SCREEN 

#2 

STORE 

D0PEN2 

RAMTOP ; RELOAD MSC FOR TEXT 


STORE 

#*60 

STORE 

#*42 

STORE 

#MXDMDE-NUMDLE i POINT X AT MIXED MODE TABLE 

OPNTMP 

OPNTMP 

OPNTMP 

NUMDLE, Y ; GET NUMBER OF DISPLAY LIST ENTRIES 

H0LD1 /STORE N DLE'S 

STORE 

D0PEN3 

DINDEX ; DO THE MESSY 320X1 PROBLEM 

#8 

D0PEN5 

#93 ; GET REMAINING NUMBER OF DLE'S 

RAMTOP ; RELOAD MEMORY SCAN COUNTER 

#*10 

STORE 

#0 

STORE 

#*4F ; (ANTIC) RELOAD MSC CODE 

STORE 

H0LD1 /DO REMAINING DLE'S 

STORE 

D0PEN4 

SAVMSC+1 /POLISH OFF DISPLAY LIST 

STORE 

SAVMSC 

STORE 

H0LD1 

#*40 

STORE 

#*70 ,-24 BLANK LINES 

STORE 
#*70 
STORE 
ADRESS 
SDLSTL 
ADRESS+1 
SDLSTL+1 


/SAVE DISPLAY LIST ADDRESS 



ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

DISPLAY HANDLER — 10-30' 

4256 

F549 

A9 

70 



LDA 

#$70 

4257 

F54B 

20 

17 

F9 


USR 

STORE 

4258 

F54E 

A5 

64 



LDA 

ADRESS 

4259 

F550 

8D 

E5 

02 


STA 

MEMTOP 

4260 

F553 

A5 

65 



LDA 

ADRESS+1 

4261 

F555 

8D 

E6 

02 


STA 

MEMTOP+ 1 

4262 

F558 

A5 

68 



LDA 

SAVADR 

4263 

F55A 

85 

64 



STA 

ADRESS 

4264 

F55C 

A5 

69 



LDA 

SAVADR+1 

4265 

F55E 

85 

65 



STA 

ADRESS+1 

4266 

F560 

AD 

31 

02 


LDA 

SDLSTL+i 

4267 

F563 

20 

17 

F9 


JSR 

STORE 

4268 

F566 

AD 

30 

02 


LDA 

SDLSTL 

4269 

F569 

20 

17 

F9 


JSR 

STORE 

4270 

F56C 

A5 

4C 



LDA 

DSTAT 

4271 

F56E 

10 

07 



BPL 

D0PEN9 

4272 

F570 

48 




PHA 


4273 

F571 

20 

FC 

F3 


JSR 

EOPEN 

4274 

F574 

68 




PLA 


4275 

F575 

A8 




TAY 


4276 

F576 

60 




RTS 


4277 

F577 

A5 

2A 


D0PEN9: 

LDA 

ICAX1Z 

4278 

F579 

29 

20 



AND 

#$20 

4279 

F57B 

DO 

OB 



BNE 

D0PEN7 

4280 

F57D 

20 

B9 

F7 


JSR 

CLRSCR 

4281 

F580 

8D 

90 

02 


STA 

TXTROW 

4282 

F583 

A5 

52 



LDA 

LMARGN 

4283 

F585 

8D 

91 

02 


STA 

TXTCOL 

4284 

F588 

A9 

22 


D0PEN7: 

LDA 

#$22 

4285 

F58A 

OD 

2F 

02 


ORA 

SDMCTL 

4286 

F58D 

8D 

2F 

02 


STA 

SDMCTL 

4287 

F590 

4C 

21 

F6 


JMP 

RETUR2 

4288 





t 



4289 





i 



4290 

F593 

20 

96 

FA 

GETCH: 

JSR 

RANGE 

4291 

F596 

20 

A2 

F5 


JSR 

GETPLT 

4292 

F599 

20 

32 

FB 


JSR 

INATAC 

4293 

F59C 

20 

D4 

F9 


JSR 

INCRSB 

4294 

F59F 

4C 

34 

F6 


JMP 

RETUR1 

4295 

F5A2 

20 

47 

F9 

GETPLT: 

JSR 

CQNVRT 

4296 

F5A5 

B 1 

64 



LDA 

(ADRESS), Y 

4297 

F5A7 

2D 

AO 

02 


AND 

DMASK 

4298 

F5AA 

46 

6F 


SHIFTD: 

LSR 

SHF AMT 

4299 

F5AC 

BO 

03 



BCS 

SHIFT1 

4300 

F5AE 

4A 




LSR 

A 

4301 

F5AF 

10 

F9 



BPL 

SHIFTD 

4302 

F5B1 

8D 

FA 

02 

SHIFT1 : 

STA 

CHAR 

4303 

F5B4 

C9 

00 



CMP 

#0 

4304 

F5B6 

60 




RTS 


4305 





f 



4306 





i 



4307 





i 



4308 

F5B7 

8D 

FB 

02 

OUTCH: 

STA 

ATACHR 

4309 

F5BA 

20 

96 

FA 


JSR 

RANGE 


78 


DISPLC 


PAGE 


97 


ADD LAST BLANK LINE ENTRY 
POSITION ADRESS=SDLSTL- 1 
STORE NEW MEMTOP 


; IF ERROR OCURRED ON ALLOCATION, OPEN THE ED 

; SAVE STATUS 
} OPEN THE EDITOR 
; RESTORE STATUS 
> AND RETURN IT TO CIO 

; TEST CLEAR INHIBIT BIT 


; CLEAR SCREEN 

; AND HOME TEXT CURSOR (AC IS ZERO) 


; EVERYTHING ELSE IS SET UP 
; SO TURN ON DMACTL 


; GETCH DOES INCRSR, GETPLT DOESN'T 
; CONVERT INTERNAL CODE TO ATASC 1 1 


i CONVERT ROW/COLUMN TO ADRESS 


; SHIFT DATA DOWN TO LOW BITS 


; (UNCONDITIONAL) 

; RESTORE FLAGS ALSO 



ERR LINE 

ADDR 

B1 

B2 

B3 B4 

DISPLAY HANDLER -- 10-30- 

4310 





; 

JSR 

OFFCRS 

4311 

F5BD 

AD 

FB 

02 

OUTCHA: 

LDA 

ATACHR 

4312 

F5C0 

C9 

7D 



CMP 

#CLRCOD 

4313 

F5C2 

DO 

06 



BNE 

OUTCHE 

4314 

F5C4 

20 

B9 

F7 


JSR 

CLRSCR 

4315 

F5C7 

4C 

21 

F6 


JMP 

RETUR2 

4316 

F5CA 

AD 

FB 

02 

OUTCHE: 

LDA 

ATACHR 

4317 

F5CD 

C9 

9B 



CMP 

#CR 

4318 

F5CF 

DO 

06 



BNE 

OUTCHB 

4319 

F5D1 

20 

30 

FA 


JSR 

DOCRWS 

4320 

F5D4 

4C 

21 

F6 


JMP 

RETUR2 

4321 

F5D7 

20 

EO 

F5 

OUTCHB : 

JSR 

OUTPLT 

4322 

F5DA 

20 

D8 

F9 


JSR 

INCRSR 

4323 

F5DD 

4C 

21 

F6 


JMP 

RETUR2 

4324 





; 



4325 





i 



4326 

F5E0 

AD 

FF 

02 

OUTPLT: 

LDA 

SSFLAG 

4327 

F5E3 

DO 

FB 



BNE 

OUTPLT 

4328 

F5E5 

A2 

02 



LDX 

#2 

4329 

F5E7 

B5 

54 


CRLOOP : 

LDA 

ROWCRS, X 

4330 

F5E9 

95 

5A 



STA 

OLDROW, X 

4331 

F5EB 

CA 




DEX 


4332 

F5EC 

10 

F9 



BPL 

CRLOOP 

4333 

F5EE 

AD 

FB 

02 


LDA 

ATACHR 

4334 

F5F1 

A8 




TAY 


4335 

F5F2 

2A 




ROL 

A 

4336 

F5F3 

2A 




ROL 

A 

4337 

F5F4 

2A 




ROL 

A 

4338 

F5F5 

2A 




ROL 

A 

4339 

F5F6 

29 

03 



AND 

#3 

4340 

F5F8 

AA 




TAX 


4341 

F5F9 

98 




TYA 


4342 

F5FA 

29 

9F 



AND 

#*9F 

4343 

F5FC 

ID 

F6 

FE 


ORA 

ATAINT, X 

4344 

F5FF 

8D 

FA 

02 

0UTCH2: 

STA 

CHAR 

4345 

F602 

20 

47 

F9 


JSR 

CONVRT 

4346 

F605 

AD 

FA 

02 


LDA 

CHAR 

4347 

F608 

46 

6F 


SHIFTU: 

LSR 

SHFAMT 

4348 

F60A 

BO 

04 



BCS 

SHIFT2 

4349 

F60C 

OA 




ASL 

A 

4350 

F60D 

4C 

08 

F6 


JMP 

SHIFTU 

4351 

F610 

2D 

AO 

02 

SHIFT2: 

AND 

DMASK 

4352 

F613 

85 

50 



STA 

TMPC HR 

4353 

F61 5 

AD 

AO 

02 


LDA 

DMASK 

4354 

F618 

49 

FF 



EOR 

#*FF 

4355 

F6 1 A 

31 

64 



AND 

(ADR ESS) , Y 

4356 

F61C 

05 

50 



ORA 

TMPCHR 

4357 

F61E 

91 

64 



STA 

(ADRESS), Y 

4358 

F620 

60 




RTS 


4359 





/ 



4360 





i 



4361 

F621 

20 

A2 

F5 

RETUR2: 

JSR 

GETPLT 

4362 

F624 

85 

5D 



STA 

OLDCHR 

4363 

F626 

A6 

57 



LDX 

DINDEX 


78 


DISPLC 


PAGE 98 


; TEST FOR CLEAR SCREEN 


; TEST FOR CARRIAGE RETURN 


; DO CR 


i *****LOOP HERE IF START/STOP FLAG IS NDN-0 


i SAVE CURSOR LOCATION FOR DRAW LINE TO DRAW 


; CONVERT ATASC II ( AT AC HR ) TO INTERNAL ( CHAR ) 
; SAVE ATACHR 


X HAS INDEX INTO ATAINT 
RESTORE ATACHR 
STRIP OFF COLUMN ADDRESS 
OR IN NEW COLUMN ADDRESS 


; SHIFT UP TO PROPER POSITION 


; SAVE SHIFTED DATA 
; INVERT MASK 

i MASK OFF OLD DATA 
i OR IN NEW DATA 

i DO CURSOR ON THE WAY OUT 
; GRAPHICS HAVE INVISIBLE CURSOR 



ERR LINE ADDR B1 B2 B3 B4 DISPLAY HANDLER — 10-30-78 — DISPLC PAGE 99 


4364 

F628 

DO 

OA 



BNE 

RETUR1 


4365 

F62A 

AE 

FO 

02 


LDX 

CRSINH 

; TEST CURSOR INHIBIT 

4366 

F62D 

DO 

05 



BNE 

RETUR1 


4367 

F62F 

49 

80 



EOR 

#$80 

; TOGGLE MSB 

4368 

F631 

20 

FF 

F5 


JSR 

0UTCH2 

; DISPLAY IT 

4369 

F634 

A4 

4C 


RETUR1 : 

LDY 

DSTAT 

i RETURN TO CIO WITH STATUS IN Y 

4370 

F636 

A9 

01 



LDA 

#SUCCES 


4371 

F638 

85 

4C 



STA 

DSTAT 

i SET STATUS 38 SUCCESSFUL COMPLETION 

4372 

F63A 

AD 

FB 

02 


LDA 

AT AC HR 

i PUT ATACHR IN AC FOR RETURN TO CIO 

4373 

F63D 

60 



NOFUNC : 

RTS 


i (NON-EXISTENT FUNCTION RETURN POINT) 


4374 ; 

4375 i 

4376 i 

4377 ; END OF DISPLAY HANDLER 

4378 ; 




ERR LINE 

ADDR 

B 1 

B2 

B3 B4 

DISPLAY HANDLER — 10-30 

4379 






PAGE 


4380 








4381 








4382 








4383 








4384 

F63E 

20 

B3 

FC 

EGETCH: 

JSR 

SWAP 

4385 

F641 

20 

88 

FA 


JSR 

ERANGE 

4386 

F644 

A5 

6B 



LDA 

BUFCNT 

4387 

F646 

DO 

34 



BNE 

EGETC3 

4388 

F648 

A5 

54 



LDA 

ROWCRS 

4389 

F64A 

85 

6C 



STA 

BUFSTR 

4390 

F64C 

A5 

55 



LDA 

COLCRS 

4391 

F64E 

85 

6D 



STA 

BUFSTR+ 1 

4392 

F650 

20 

E2 

F6 

EGETC 1 : 

JSR 

KGETCH ; LE 

4393 

F653 

84 

4C 



STY 

DSTAT 

4394 

F655 

AD 

FB 

02 


LDA 

AT AC HR 

4395 

F658 

C9 

9B 



CMP 

#CR 

4396 

F65A 

FO 

12 



BEG 

EGETC2 

4397 

F65C 

20 

AD 

F6 


JSR 

DOSS 

4398 

F65F 

20 

B3 

FC 


JSR 

SWAP 

4399 

F662 

A5 

63 



LDA 

LOGCOL 

4400 

F664 

C9 

71 



CMP 

#113 

4401 

F666 

DO 

03 



BNE 

EGETC6 

4402 

F668 

20 

OA 

F9 


JSR 

BELL 

4403 

F66B 

4C 

50 

F6 

EGETC6: 

JMP 

EGETC 1 

4404 

F66E 

20 

E4 

FA 

EGETC2: 

JSR 

OFFCRS 

4405 

F671 

20 

00 

FC 


JSR 

DOBUFC 

4406 

F674 

A5 

6C 



LDA 

BUFSTR 

4407 

F676 

85 

54 



STA 

ROWCRS 

4408 

F678 

A5 

6D 



LDA 

BUFSTR+1 

4409 

F67A 

85 

55 



STA 

COLCRS 

4410 

F67C 

A5 

6B 


EGETC3: 

LDA 

BUFCNT 

4411 

F67E 

FO 

11 



BEG 

EGETC 5 

4412 

F680 

C6 

6B 


EGETC7: 

DEC 

BUFCNT 

4413 

F682 

FO 

OD 



BEG 

EGETC5 

4414 

F684 

A5 

4C 



LDA 

DSTAT 

4415 

F686 

30 

F8 



BMI 

EGETC7 

4416 

F688 

20 

93 

F5 


JSR 

GETCH 

4417 

F68B 

8D 

FB 

02 


STA 

ATACHR 

4418 

F68E 

4C 

B3 

FC 


JMP 

SWAP 

4419 

F691 

20 

30 

FA 

EGETC 5: 

JSR 

DOCRWS 

4420 

F694 

A9 

9B 



LDA 

#CR 

4421 

F696 

8D 

FB 

02 


STA 

ATACHR 

4422 

F699 

20 

21 

F6 


JSR 

RETUR2 

4423 

F69C 

84 

4C 



STY 

DSTAT 

4424 

F69E 

4C 

B3 

FC 


JMP 

SWAP 

4425 





I 



4426 

F6A1 

6C 

64 

00 

JSRIND: 

JMP 

(ADRESS) 

4427 





i 



4428 

F6A4 

8D 

FB 

02 

EOUTCH: 

STA 

ATACHR 

4429 

F6A7 

20 

B3 

FC 


JSR 

SWAP 

4430 

F6AA 

20 

88 

FA 


JSR 

ERANGE 

4431 

F6AD 

20 

E4 

FA 

DOSS: 

JSR 

OFFCRS 

4432 

F6B0 

20 

8D 

FC 


JSR 

TSTCTL 


78 


DISPLC 


PAGE 100 


; ANYTHING IN THE BUFFER? 

; YES 

; NO, SO SAVE BUFFER START ADDRESS 


'S FILL OUR BUFFER 
SAVE KEYBOARD STATUS 
; TEST FOR CR 


NO, SO PRINT IT 

JSR DOSS DID SWAP SO SWAP BACK 
BEEP IF NEARING LOGICAL COL 120 


i GET BUFFER COUNT 
; RETURN A CHARACTER 


; AND RETURN TILL BUFCNT=0 

i IF ERR, LOOP ON EGETC7 UNTIL BUFR IS EMPTIE 


iAND RETURN WITHOUT TURNING CURSOR BACK ON 
; DO REAL CARRIAGE RETURN 
; AND RETURN EOL 

i TURN ON CURSOR THEN SWAP 
; SAVE KEYBOARD STATUS 
; AND RETURN THROUGH RETUR1 

; JSR TO THIS CAUSES JSR INDIRECT 

; SAVE ATASCII VALUE 


; TURN OFF CURSOR 

i TEST FOR CONTROL CHARACTERS <Z=1 IF CTL> 



ERR LINE 

ADDR 

B1 

B2 

B3 B4 

DISPLAY HANDLER — 10-30-78 — DISPLC PAGE 

101 

4433 

F6B3 

F0 

09 



BEG 

E0UTC5 



4434 

F6B5 

OE 

A2 

02 E0UTC6: 

ASL 

ESCFLG 

ESCFLG ONLY WORKS ONCE 


4435 

F6B8 

20 

CA 

F5 


JSR 

OUTCHE 



4436 

F6BB 

4C 

B3 

FC ERETN: 

JMP 

SWAP 

AND RETURN THROUGH RETUR1 


4437 

F6BE 

AD 

FE 

02 E0UTC5: 

LDA 

DSPFLG 

DO DSPFLG AND ESCFLG 


4438 

F6C 1 

OD 

A2 

02 


ORA 

ESCFLG 



4439 

F6C4 

DO 

EF 



BNE 

E0UTC6 

IF NON— 0 DISPLAY RATHER THAN EXECUTE 

IT 

4440 

F6C6 

OE 

A2 

02 


ASL 

ESCFLG 



4441 

F6C9 

E8 




INX 

i PROCESS CONTROL CHARACTERS 


4442 

F6CA 

BD 

C6 

FE 


LDA 

CNTRLS, X 

GET DISPLACEMENT INTO ROUTINE 


4443 

F6CD 

85 

64 



STA 

ADRESS 



4444 

F6CF 

BD 

C7 

FE 


LDA 

CNTRLS+1, X 

GET HIGH BYTE 


4445 

F6D2 

85 

65 



STA 

ADRESS+1 



4446 

F6D4 

20 

A1 

F6 


JSR 

JSR IND 

DO COMPUTED JSR 


4447 

F6D7 

20 

21 

F6 


JSR 

RETUR2 

DO CURSOR 


4448 

4449 

4450 

4451 

4452 

F6DA 

4C 

B3 

FC 


JMP 

SWAP 

ALL DONE SO RETURN THROUGH RETUR1 


4453 





END SCREEN 

EDITOR. 



4454 

4455 










4456 





BEGIN 

KEYBOARD HANDLER 



4457 

4458 

4459 

4460 










4461 

F6DD 

A9 

FF 

KGETC2: 

LDA 

#$FF 



4462 

F6DF 

8D 

FC 

02 


STA 

CH 



4463 

F6E2 

A5 

2A 

KGETCH: 

LDA 

ICAX1Z 

TEST LSB OF AUX1 FOR SPECIAL EDITOR READ MO 

4464 

F6E4 

4A 




LSR 

A 



4465 

F6E5 

BO 

62 



BCS 

GETOUT 



4466 

F6E7 

A9 

80 



LDA 

#BRKABT 



4467 

F6E9 

A6 

11 



LDX 

BRKKEY 

TEST BREAK 


4468 

F6EB 

FO 

58 



BEG 

K7 

IF BREAK, PUT BRKABT IN DSTAT AND CR 

IN AT A 

4469 

F6ED 

AD 

FC 

02 


LDA 

CH 



4470 

F6F0 

C9 

FF 



CMP 

#$FF 



4471 

F6F2 

FO 

EE 



BEG 

KGETCH 



4472 

F6F4 

85 

7C 



STA 

HOLDCH 

SAVE CH FOR SHIFT LOCK PROC 


4473 

F6F6 

A2 

FF 



LDX 

#$FF 

"CLEAR *' CH 


4474 

F6F8 

8E 

FC 

02 


STX 

CH 



4475 

F6FB 

20 

D8 

FC 


JSR 

CLICK 

DO KEYBOARD AUDIO FEEDBACK (A IS OK) 


4476 

F6FE 

AA 


KGETC3: 

TAX 


DO ASCCON 


4477 

F6FF 

EO 

CO 



CPX 

#$C0 

TEST FOR CTL & SHIFT TOGETHER 


4478 

F701 

90 

02 



BCC 

ASCC01 



4479 

F703 

A2 

03 



LDX 

#3 

BAD CODE 


4480 

F705 

BD 

FE 

FE ASCCQ1 : 

LDA 

ATASCI, X 



4481 

F708 

8D 

FB 

02 


STA 

ATACHR 

DONE 


4482 

F70B 

C9 

80 



CMP 

#$80 

DO NULLS 


4483 

F70D 

FO 

CE 



BEG 

KGETC2 



4484 

F70F 

C9 

81 



CMP 

#$81 ; CHECK ATARI KEY 


4485 

F71 1 

DO 

OB 



BNE 

KGETC1 



4486 

F713 

AD 

B6 

02 


LDA 

INVFLG 
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4487 

F716 

49 

80 



EOR 

#$80 



4488 

F718 

8D 

B6 

02 


STA 

INVFLG 



4489 

F71B 

4C 

DD 

F6 


JMP 

KGETC2 

DONT RETURN A VALUE 


4490 

F71E 

C9 

82 


KGETC1 : 

CMP 

#$82 

CAPS/LOWER. 


4491 

F720 

DO 

07 



BNE 

K1 



4492 

F722 

A9 

00 



LDA 

#0 

CLEAR SHFLOK 


4493 

F724 

8D 

BE 

02 


STA 

SHFLOK 



4494 

F727 

FO 

B4 



BEQ 

KGETC2 



4495 

F729 

C9 

83 


K1 : 

CMP 

#$83 

SHIFT CAPS/LOWER 


4496 

F72B 

DO 

07 



BNE 

K2 



4497 

F72D 

A9 

40 



LDA 

#$40 



4498 

F72F 

8D 

BE 

02 


STA 

SHFLOK 

SHIFT BIT 


4499 

F732 

DO 

A9 



BNE 

KGETC2 



4500 

F734 

C9 

84 


K2: 

CMP 

#$84 

CNTL CAPS/LOWER 


4501 

F736 

DO 

07 



BNE 

K3 



4502 

F738 

A9 

80 



LDA 

#$80 

CNTL BIT 


4503 

F73A 

8D 

BE 

02 


STA 

SHFLOK 



4504 

F73D 

DO 

9E 



BNE 

KGETC2 



4505 

F73F 

C9 

85 


K3: 

CMP 

#$85 

DO EOF 


4506 

F741 

DO 

OA 



BNE 

K6 



4507 

F743 

A9 

88 



LDA 

#EOFERR 



4508 

F745 

85 

4C 


K7: 

STA 

DSTAT 



4509 

F747 

85 

11 



STA 

BRKKEY 

RESTORE BREAK 


4510 

F749 

A9 

9B 


GETOUT: 

LDA 

#CR 

PUT CR IN ATACHR 


4511 

F74B 

DO 

26 



BNE 

K8 

(UNCONDITIONAL) 


4512 

F74D 

A5 

7C 


K6: 

LDA 

HOLDCH 

PROCESS SHIFT LOCKS 


4513 

F74F 

€9 

40 



CMP 

#$40 

REGULAR SHIFT AND CONTROL 

TAKE PRECEDENCE 

4514 

F751 

BO 

15 



BCS 

K5 

OVER LOCK 


4515 

F753 

AD 

FB 

02 


LDA 

AT AC HR 

TEST FOR ALPHA 


4516 

F756 

C9 

61 



CMP 

#$61 

LOWER CASE A 


4517 

F758 

90 

OE 



BCC 

K5 

NOT ALPHA IF LT 


4518 

F75A 

€9 

7B 



CMP 

#$7B 

LOWER CASE Z+l 


4519 

F75C 

BO 

OA 



BCS 

K5 

NOT ALPHA IF GE 


4520 

F75E 

AD 

BE 

02 


LDA 

SHFLOK 

DO SHIFT/CONTROL LOCK 


4521 

F761 

FO 

05 



BEQ 

K5 

IF NO LOCK, DONT RE-DO IT 


4522 

F763 

05 

7C 



ORA 

HOLDCH 



4523 

F765 

4C 

FE 

F6 


JMP 

KGETC3 

DO RETRY 


4524 

F768 

20 

8D 

FC 

K5: 

JSR 

TSTCTL 

DONT INVERT MSB OF CONTROL 

CHARACTERS 

4525 

F76B 

FO 

09 



BEQ 

K4 



4526 

F76D 

AD 

FB 

02 


LDA 

ATACHR 



4527 

F770 

4D 

B6 

02 


EOR 

INVFLG 



4528 

F773 

8D 

FB 

02 

K8 : 

STA 

ATACHR 



4529 

F776 

4C 

34 

F6 

K4: 

JMP 

RETUR1 ALL DONE 



4530 

4531 
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4532 






. PAGE 




4533 





} 





4534 





i 





4535 





i CONTROL CHARACTER PROCESSORS 


4536 





i 





4537 

F779 

A9 

80 


ESCAPE 

LDA 

#*80 

; SET ESCAPE FLAG 


4538 

F77B 

8D 

A2 

02 


STA 

ESCFLG 



4539 

F77E 

60 




RTS 




4540 

F77F 

C6 

54 


CRSRUP 

DEC 

ROWCRS 



4541 

F781 

10 

06 



BPL 

COMRET 



4542 

F783 

AE 

BF 

02 


LDX 

BOTSCR 

; WRAPAROUND 


4543 

F786 

CA 




DEX 




4544 

F787 

86 

54 


UP DNCM 

STX 

ROWCRS 



4545 

F789 

4C 

5C 

FC 

COMRET 

JMP 

STRBEG 

; COLVERT ROW AND COL TO LOGCOL 

AND RETURN 

4546 

F78C 

E6 

54 


CRSRDN 

INC 

ROWCRS 



4547 

F78E 

A5 

54 



LDA 

ROWCRS 



4548 

F790 

CD 

BF 

02 


CMP 

BOTSCR 



4549 

F793 

90 

F4 



BCC 

COMRET 



4550 

F795 

A2 

00 



LDX 

#0 



4551 

F797 

F0 

EE 



BEG 

UP DNCM 

; (UNCONDITIONAL) 


4552 

F799 

C6 

55 


CRSRLF 

DEC 

COLCRS 



4553 

F79B 

A5 

55 



LDA 

COLCRS 



4554 

F79D 

30 

04 



BMI 

CRSRL1 

» < IF LMARGN=0» THIS ELIMINATES 

PROBLEM CASE) 

4555 

F79F 

C5 

52 



CMP 

LMARGN 



4556 

F7A1 

BO 

04 



BCS 

C0MRE1 



4557 

F7A3 

A5 

53 


CRSRL1 

LDA 

RMARGN 



4558 

F7A5 

85 

55 


LFRTCM 

STA 

COLCRS 



4559 

F7A7 

4C 

DD 

FB 

C0MRE1 

JMP 

DOLCOL 

iCOLVERT ROW AND COL TO LOGCOL 

AND RETURN 

4560 

F7AA 

E6 

55 


CRSRRT 

INC 

COLCRS 



4561 

F7AC 

A5 

55 



LDA 

COLCRS 



4562 

F7AE 

C5 

53 



CMP 

RMARGN 



4563 

F7B0 

90 

F5 



BCC 

C0MRE1 



4564 

F7B2 

FO 

F3 



BEG 

CQMRE1 

; (CAUSE BLE) 


4565 

F7B4 

A5 

52 



LDA 

LMARGN 



4566 

F7B6 

4C 

A5 

F7 


JMP 

LFRTCM 

; UNCONDITIONAL TO COMMON STORE 


4567 

F7B9 

20 

F3 

FC 

CLRSCR 

JSR 

PUTMSC 



4568 

F7BC 

AO 

00 



LDY 

#0 



4569 

F7BE 

98 




TYA 


» PUT 0 IN THE AC 


4570 

F7BF 

91 

64 


CLRSC2 

STA 

(ADRESS), Y 

; (AC IS ZERO) 


4571 

F7C 1 

C8 




I NY 




4572 

F7C2 

DO 

FB 



BNE 

CLRSC2 



4573 

F7C4 

E6 

65 



INC 

ADRESS+1 



4574 

F7C6 

A6 

65 



LDX 

ADRESS+1 



4575 

F7C8 

E4 

6A 



CPX 

RAMTOP 



4576 

F7CA 

90 

F3 



BCC 

CLRSC2 



4577 

F7CC 

A9 

FF 



LDA 

#*FF 

; CLEAN UP LOGICAL LINE BIT MAP 


4578 

F7CE 

99 

B2 

02 

CLRSC3 

STA 

LOGMAP. Y 

; (Y IS ZERO AFTER CLRSC2 LOOP) 


4579 

F7D1 

C8 




I NY 




4580 

F7D2 

CO 

04 



CP Y 

#4 



4581 

F7D4 

90 

F8 



BCC 

CLRSC3 



4582 

F7D6 

20 

E4 

FC 

HOME: 

JSR 

COLCR 

.PLACE COLCRS AT LEFT EDGE 


4583 

F7D9 

85 

63 



STA 

LOGCOL 



4584 

F7DB 

85 

6D 



STA 

BUFSTR+1 



4585 

F7DD 

A9 

00 



LDA 

#0 





ERR LINE 

ADDR 

B1 

B2 

B3 B4 

DISPLAY HANDLER — 10-30-78 -- DISPLC 

PAGE 

104 

4586 

F7DF 

85 

54 



STA 

RQWCRS 




4587 

F7E1 

85 

56 



STA 

COLCRS+1 




4588 

F7E3 

85 

6C 



STA 

BUFSTR 




4589 

F7E5 

60 




RTS 





4590 





; 






4591 

F7E6 

A5 

63 


BS: 

LDA 

LOGCOL 

BACKSPACE 



4592 

F7E8 

C 5 

52 



CMP 

LMARGN 




4593 

F7EA 

F0 

21 



BEG 

BS1 




4594 

F7EC 

A5 

55 


BSA: 

LDA 

COLCRS ; LEFT EDGE? 



4595 

F7EE 

€5 

52 



CMP 

LMARGN 




4596 

F7F0 

DO 

03 



BNE 

BS3 ; NO 



4597 

F7F2 

20 

73 

FC 


JSR 

DELTIM 

YES, SEE IF LINE SHOULD BE DELETED 


4598 

F7F5 

20 

99 

F7 

BS3: 

JSR 

CRSRLF 




4599 

F7F8 

A5 

55 



LDA 

COLCRS 




4600 

F7FA 

C5 

53 



CMP 

RMARGN 




4601 

F7FC 

DO 

07 



BNE 

BS2 




4602 

F7FE 

A5 

54 



LDA 

ROWCRS 




4603 

F800 

FO 

03 



BEQ 

BS2 




4604 

F802 

20 

7F 

F7 


JSR 

CRSRUP 




4605 

F805 

A9 

20 


BS2: 

LDA 

#$20 ; MAKE BACKSPACE DESTRUCTIVE 



4606 

F807 

8D 

FB 

02 


STA 

ATACHR 




4607 

F80A 

20 

EO 

F5 


JSR 

OUTPLT 




4608 

F80D 

4C 

DD 

FB 

BS1 : 

JMP 

DOLCOL 

AND RETURN 



4609 

F810 

20 

AA 

F7 

TAB: 

JSR 

CRSRRT 

BEGIN SEARCH 



4610 

F813 

A5 

55 



LDA 

COLCRS 

TEST FOR NEW LINE 



4611 

F81 5 

C5 

52 



CMP 

LMARGN 




4612 

F81 7 

DO 

OA 



BNE 

TAB! 

NO 



4613 

F819 

20 

34 

FA 


JSR 

DOCR 

DO CARRIAGE RETURN 



4614 

F81C 

20 

20 

FB 


JSR 

LOGGET 

CHECK IF END OF LOGICAL LINE 



4615 

F81F 

90 

02 



BCC 

TAB 1 

NO, CONTINUE 



4616 

F821 

BO 

07 



BCS 

TAB2 

(UNCONDITIONAL) 



4617 

F823 

A5 

63 


TAB 1 : 

LDA 

LOGCOL 

CHECK FOR TAB STOP 



4618 

F825 

20 

25 

FB 


JSR 

BITGET 




4619 

F828 

90 

E6 



BCC 

TAB 

NO, SO KEEP LOOKING 



4620 

F82A 

4C 

DD 

FB 

TAB2: 

JMP 

DOLCOL ; COLVERT ROW AND COL TO LOGCOL 

AND RETURN 

4621 

F82D 

A5 

63 


SETTAB: 

LDA 

LOGCOL 




4622 

F82F 

4C 

06 

FB 


JMP 

BITSET 

SET BIT IN MAP AND RETURN 



4623 

F832 

A5 

63 


CLRTAB : 

LDA 

LOGCOL 




4624 

F834 

4C 

12 

FB 


JMP 

BITCLR 

CLEAR " " 



4625 

F837 

20 

9D 

FC 

INSCHR : 

JSR 

PHACRS 




4626 

F83A 

20 

A2 

F5 


JSR 

GETPLT 

GET CHARACTER UNDER CURSOR 



4627 

F83D 

85 

7D 



STA 

INSDAT 




4628 

F83F 

A9 

00 



LDA 

#0 




4629 

F841 

8D 

BB 

02 


STA 

SCRFLG 




4630 

F844 

20 

FF 

F5 

INSCH4: 

JSR 

0UTCH2 

STORE DATA 



4631 

F847 

A5 

63 



LDA 

LOGCOL 

SAVE LOGCOL: IF AFTER INCRSA 

LOGCOL 

IS 

4632 

F849 

48 




PHA 


< THAN IT IS NOW, END LOOP 



4633 

F84A 

20 

DC 

F9 


JSR 

INCRSA 

SPECIAL INCRSR ENTRY POINT 



4634 

F84D 

68 




PLA 





4635 

F84E 

05 

63 



CMP 

LOGCOL 




4636 

F850 

BO 

OC 



BCS 

INSCH3 

QUIT 



4637 

F852 

A5 

7D 


INSCH1 : 

LDA 

INSDAT 

KEEP GOING 



4638 

F854 

48 




PHA 





4639 

F855 

20 

A2 

F5 


JSR 

GETPLT 
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4640 

F858 

85 

7D 



STA 

INSDAT 


4641 

F85A 

68 




PLA 



4642 

F85B 

4C 

44 

F8 


JMP 

INSCH4 


4643 

F85E 

20 

A8 

FC 

INSCH3: 

JSR 

PLACRS 


4644 

F861 

CE 

BB 

02 

INSCH6: 

DEC 

SCRFLG 


4645 

F864 

30 

04 



BMI 

INSCH5 

IF SCROLL OCCURRED 

4646 

F866 

C6 

54 



DEC 

ROWCRS 

MOVE CURSOR UP 

4647 

F868 

DO 

F7 



BNE 

INSCH6 

(UNCOND) CONTINUE UNTIL SCRFLG IS MINUS 

4648 

FS6A 

4C 

DD 

FB 

INSCH5: 

JMP 

DQLCGL 

COLVERT ROW AND COL TO LOGCOL AND RETURN 

4649 





; 




4650 





i 




4651 

F86D 

20 

9D 

FC 

DELCHR ; 

JSR 

PHACRS 


4652 

F870 

20 

47 

F9 

DELCH1 : 

JSR 

CONVRT 

GET DATA TO THE RIGHT OF THE CURSOR 

4653 

F873 

A5 

64 



LDA 

ADRESS 


4654 

F875 

85 

68 



STA 

SAVADR 

SAVE ADRESS TO KNOW WHERE TO PUT DATA 

4655 

F877 

A5 

65 



LDA 

ADRESS+1 


4656 

F879 

85 

69 



STA 

SAVADR+1 


4657 

F87B 

A5 

63 



LDA 

LOGCOL 


4658 

F87D 

4e 




PHA 



4659 

F87E 

20 

D4 

F9 


JSR 

INCRSB 

PUT CURSOR OVER NEXT CHARACTER 

4660 

F881 

68 




PLA 



4661 

F882 

€5 

63 



CMP 

LOGCOL 

TEST NEW LOGCOL AGAINST OLD LOGCOL 

4662 

F884 

BO 

10 



BCS 

DELCH2 

IF OLD. GE. NEW THEN QUIT 

4663 

F886 

A5 

54 



LDA 

ROWCRS 

IS ROW OFF SCREEN? 

4664 

F888 

CD 

BF 

02 


CMP 

BOTSCR 


4665 

F88B 

BO 

09 



BCS 

DELCH2 

YES, SO QUIT 

4666 

F88D 

20 

A2 

F5 


JSR 

GETPLT ; GET DATA UNDER CURSOR 

4667 

F890 

AO 

00 



LDY 

#0 


4668 

F892 

91 

68 



STA 

( SAVADR > , Y 

PUT IT IN PREVIOUS POSITION 

4669 

F894 

FO 

DA 



BEG 

DELCH1 

AND LOOP (UNCONDITIONAL) 

4670 

F896 

AO 

00 


DELCH2: 

LDY 

#0 


4671 

F898 

98 




TYA 



4672 

F899 

91 

68 



STA 

(SAVADR >,Y i CLEAR THE LAST POSITION 

4673 

F89B 

20 

68 

FC 


JSR 

DELTIA ; TRY TO DELETE A LINE 

4674 

F89E 

20 

A8 

FC 


JSR 

PLACRS 


4675 

F8A1 

4C 

DD 

FB 


JMP 

DOLCOL 

AND RETURN 

4676 

F8A4 

38 



INSLIN: 

SEC 


NORMAL INSLIN PUTS "1" INTO BIT MAP 

4677 

F8A5 

20 

7B 

FB 

INSLIA: 

JSR 

EXTEND 

ENTRY POINT FOR C=0 

4678 

F8A8 

A5 

52 



LDA 

LMARGN 

DO CARRIAGE RETURN (NO LF) 

4679 

F8AA 

85 

55 



STA 

COLCRS 


4680 

F8AC 

20 

47 

F9 


JSR 

CONVRT 

GET ADDRESS 

4681 

F8AF 

A5 

64 



LDA 

ADRESS 

SET UP T0=40+FR0M (FROM = CURSOR) 

4682 

F8B 1 

85 

68 



STA 

FRMADR 


4683 

F8B3 

18 




CLC 



4684 

F8B4 

69 

28 



ADC 

#40 


4685 

F8B6 

85 

66 



STA 

TOADR 


4686 

F8B8 

A5 

65 



LDA 

ADRESS+1 


4687 

F8BA 

85 

69 



STA 

FRMADR+1 


4688 

F8BC 

69 

00 



ADC 

#0 


4689 

F8BE 

85 

67 



STA 

TOADR +1 


4690 

F8C0 

A6 

54 



LDX 

ROWCRS 

SET UP LOOP COUNTER 

4691 

F8C2 

EO 

17 



CPX 

#23 


4692 

F8C4 

FO 

08 



BEQ 

INSLI2 


4693 

F8C6 

20 

4E 

FB 

INSLI1: 

JSR 

MOVLIN 
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4694 

F8C9 

E8 




INX 


4695 

F8CA 

EO 

17 



CPX 

#23 

4696 

F8CC 

DO 

F8 



BNE 

INSLI1 

4697 

F8CE 

20 

9B 

FB 

INSLI2: 

JSR 

CLRLIN 

4698 

F8D1 

4C 

DD 

FB 


JMP 

DOLCOL 

4699 

F8D4 

20 

DD 

FB 

DELL IN: 

JSR 

DOLCOL 

4700 

F8D7 

A4 

51 


DELL I A: 

LDY 

H0LD1 

4701 

F8D9 

84 

54 



STY 

RQWCRS 

4702 

F8DB 

A4 

54 


DELLIB: 

LDY 

RQWCRS 

4703 

F8DD 

98 



DELLI1: 

TYA 


4704 

F8DE 

38 




SEC 


4705 

F8DF 

20 

23 

FB 


JSR 

L02GET 

4706 

F8E2 

08 




PHP 


4707 

F8E3 

98 




TYA 


4708 

F8E4 

18 




CLC 


4709 

F8E5 

69 

78 



ADC 

#120 

4710 

F8E7 

28 




PLP 


4711 

F8E8 

20 

04 

FB 


JSR 

BITPUT 

4712 

F8EB 

ce 




INY 


4713 

F8EC 

co 

18 



CPY 

#24 

4714 

F8EE 

DO 

ED 



BNE 

DELL 11 

4715 

F8F0 

AD 

B4 

02 


LDA 

LQGMAP+2 

4716 

F8F3 

09 

01 



ORA 

#1 

4717 

F8F5 

8D 

B4 

02 


STA 

LOGMAP+2 

4718 

F8F8 

A5 

52 


DELL 12: 

LDA 

LMARGN 

4719 

F8FA 

85 

55 



STA 

COLCRS 

4720 

F8FC 

20 

47 

F9 


JSR 

CONVRT 

4721 

F8FF 

20 

B7 

FB 


JSR 

SCR0L1 

4722 

F902 

20 

20 

FB 


JSR 

LOGGET 

4723 





; IS IT 

A NEW 

LOG LINE? 

4724 

F905 

90 

D4 



BCC 

DELLIB 

4725 

F907 

4C 

DD 

FB 


JMP 

DOLCOL 

4726 

F90A 

AO 

20 


BELL: 

LDY 

#*20 

4727 

F90C 

20 

D8 

FC 

BELLI: 

JSR 

CLICK 

4728 

F90F 

ee 




DEY 


4729 

F910 

10 

FA 



BPL 

BELLI 

4730 

F912 

60 




RTS 
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CLEAR CURRENT LINE 

COLVERT ROW AND COL TO LOGCOL AND RETURN 
GET BEGINNING OF LOG LINE (H0LD1 ) 

SQUEEZE BIT MAP 
PUT CURSOR THERE 


; GET NEXT BIT 


i WRITE IT OVER PRESENT BIT 


; LOOP 
; SET LSB 


; DELETE LINE OF DATA USING PART OF SCROLL 
; CR NO LF 


; TEST NEXT LINE FOR CONTINUATION 

; NO SO DELETE ANOTHER 
; YES SO DOLCOL AND RETURN 



ERR LINE ADDR B1 B2 B3 B4 
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4731 

4732 

4733 

4734 

4735 

4736 

4737 

4738 

4739 

4740 F913 A9 02 

4741 F91 5 DO OA 

4742 

4743 

4744 

4745 F917 A4 4C 

4746 F919 30 2B 

4747 F91B AO 00 

4748 F91D 91 64 

4749 

4750 

4751 F91F A9 01 

4752 F921 8D 9E 02 

4753 F924 A5 4C 

4754 F926 30 IE 

4755 F928 A5 64 

4756 F92A 38 

4757 F92B ED 9E 02 

4758 F92E 85 64 

4759 F930 BO 02 

4760 F932 C6 65 

4761 F934 A5 OF 

4762 F936 C5 65 

4763 F93Q 90 OC 

4764 F93A DO 06 

4765 F93C A5 OE 

4766 F93E C5 64 

4767 F940 90 04 

4768 F942 A9 93 

4769 F944 85 4C 

4770 F946 60 

4771 

4772 

4773 

4774 

4775 

4776 F947 A5 54 

4777 F949 48 

4778 F94A A5 55 

4779 F94C 48 

4780 F94D A5 56 

4781 F94F 48 

4782 F950 20 F3 FC 

4783 F953 A5 54 

4784 F955 85 66 


. PAGE 


ROUTINES 


; DOUBLE BYTE DECREMENT OF INDIRECT POINTER 
i INCLUDING DB SUBTRACT AND DB DOUBLE DECREMENT 

i 

DBDDEC: LDA #2 

BNE DBSUB ; (UNCONDITIONAL) 

i 

! STORE DATA INDIRECT AND DECREMENT POINTER 
i (PLACED HERE TO SAVE JMP DBDEC AFTER STORE) 
STORE: LDY DSTAT ; RETURN ON ERROR 

BMI STROK 

LDY #0 

STORE 1: STA ( ADRESS ) , Y 

} JMP DBDEC DECREMENT AND RETURN 


DBDEC: LDA #1 

DBSUB: STA SUBTMP 

LDA DSTAT ; RETURN ON ERROR 

BMI STROK 

LDA ADRESS 

SEC 

SBC SUBTMP 

STA ADRESS 

BCS DBSUB 1 

DEC ADRESS+1 

DBSUB 1 : LDA APPMHI+1 /MAKE SURE NOTHING EVER OVERWRITES APPMHI 

CMP ADRESS+1 

BCC STROK ; OK 

BNE STRERR ; ERROR 

LDA APPMHI 

CMP ADRESS 

BCC STROK 

STRERR: LDA #SCRMEM ; SHOW MEM TOO SMALL FOR SCREEN ERROR 

STA DSTAT 

STROK: RTS 


CONVERT ROW/COLUMN CURSOR INTO REAL ADDRESS (FROM SAVMSC ON UP) 


CONVRT : LDA ROWCRS ; SAVE CURSOR 

PHA 

LDA COLCRS 

PHA 

LDA COLCRS+1 

PHA 

JSR PUTMSC 

LDA ROWCRS ; PUT 10*R0WCRS INTO MLTTMP 

STA MLTTMP 



ERR. LINE 

ADDR 

B 1 

B2 

B3 B4 

DISPLAY HANDLER — 10-30- 

•78 — DISPLC PAGE 108 

4785 

F957 

A9 

00 



LDA 

#0 


4786 

F959 

85 

67 



STA 

MLTTMP+1 


4787 

F95B 

A5 

66 



LDA 

MLTTMP 

; QUICK X8 

4788 

F95D 

0A 




ASL 

A 


4789 

F95E 

26 

67 



ROL 

MLTTMP+I 


4790 

F960 

85 

51 



STA 

H0LD1 

; ( SAOE 2X OALUE) 

4791 

F962 

A4 

67 



LDY 

MLTTMP+1 

; " " 

4792 

F964 

8C 

9F 

02 


STY 

HQLD2 

i "" 

4793 

F967 

OA 




ASL 

A 


4794 

F968 

26 

67 



ROL 

MLTTMP+1 


4795 

F96A 

OA 




ASL 

A 


4796 

F96B 

26 

67 



ROL 

MLTTMP+1 


4797 

F96D 

18 




CLC 


i ADD IN 2X 

4798 

F96E 

65 

51 



ADC 

H0LD1 


4799 

F970 

85 

66 



STA 

MLTTMP 


4800 

F972 

A5 

67 



LDA 

MLTTMP+1 


4801 

F974 

6D 

9F 

02 


ADC 

H0LD2 


4802 

F977 

85 

67 



STA 

MLTTMP+1 


4803 

F979 

A6 

57 



LDX 

DINDEX 

i NOW SHIFT MLTTMP LEFT DHLINE TIMES TO FINIS 

4804 

F97B 

BC 

81 

FE 


LDY 

DHLINE, X 

; MULTIPLY 

4805 

F97E 

88 



CONOR 1: 

DEY 


; LOOP N TIMES 

4806 

F97F 

30 

07 



BMI 

C0NVR2 


4807 

F981 

06 

66 



ASL 

MLTTMP 


4808 

F983 

26 

67 



ROL 

MLTTMP+1 


4809 

F985 

4C 

7E 

F9 


JMP 

CONOR! 


4810 

F988 

BC 

A5 

FE 

C0NVR2: 

LDY 

DI02TB, X 

; NOW DIOIDE HCRSR TO ACCOUNT FOR PARTIAL BYT 

4811 

F98B 

A5 

55 



LDA 

COLCRS 


4812 

F98D 

A2 

07 



LDX 

#7 

; * TRICKY * 

4813 

F98F 

88 



C0NVR3: 

DEY 



4814 

F990 

30 

OA 



BMI 

CONOR 4 


4815 

F992 

CA 




DEX 



4816 

F993 

46 

56 



LSR 

CQLCRS+1 


4817 

F995 

6A 




ROR 

A 


4818 

F996 

6E 

A1 

02 


ROR 

TMPLBT 

; SAOE LOW BITS FOR MASK 

4819 

F999 

4C 

8F 

F9 


JMP 

C0N0R3 


4820 

F99C 

C8 



CONOR 4: 

INY 


; SO Y IS ZERO UPON RETURN FROM THIS ROUTINE 

4821 

F99D 

18 




CLC 



4822 

F99E 

65 

66 



ADC 

MLTTMP 

; ADD SHIFTED COLCRS TO MLTTMP 

4823 

F9A0 

85 

66 



STA 

MLTTMP 


4824 

F9A2 

90 

02 



BCC 

CONOR 5 


4825 

F9A4 

E6 

67 



INC 

MLTTMP+1 


4826 

F9A6 

38 



CONORS: 

SEC 


; * TRICKY * 

4827 

F9A7 

6E 

A1 

02 

C0NVR6: 

ROR 

TMPLBT 

; SLIDE A "l" UP AGAINST LOW BITS (CONTINUE T 

4828 

F9AA 

18 




CLC 



4829 

F9AB 

CA 




DEX 


; AND FINISH SHIFT SO LOW BITS ARE 

4830 

F9AC 

10 

F9 



BPL 

C0N0R6 

i RIGHT JUSTIFIED. 

4831 

F9AE 

AE 

A1 

02 


LDX 

TMPLBT 

i TMPLBT IS NOW THE INDEX INTO DMASKTB 

4832 

F9B 1 

A5 

66 



LDA 

MLTTMP 

i PREPARE FOR RETURN 

4833 

F9B3 

18 




CLC 



4834 

F9B4 

65 

64 



ADC 

ADR ESS 


4835 

F9B6 

85 

64 



STA 

ADRESS 


4836 

F9B8 

85 

5E 



STA 

OLDADR 

; REMEMBER THIS ADDRESS FOR CURSOR 

4837 

F9BA 

A5 

67 



LDA 

MLTTMP+1 


4838 

F9BC 

65 

65 



ADC 

ADRESS+1 




ERR LINE 
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4839 

F9BE 

85 

65 



STA 

ADRESS+1 


4840 

F9C0 

85 

5F 



STA 

OLDADR+1 


4841 

F9C2 

BD 

Bl 

FE 


LDA 

DMASKT , X 


4842 

F9C5 

8D 

AO 

02 


STA 

DMASK 


4843 

F9C8 

85 

6F 



STA 

SHF AMT 


4844 

F9CA 

68 




PLA 



4845 

F9CB 

85 

56 



STA 

COLCRS+ 1 


4846 

F9CD 

68 




PLA 



4847 

F9CE 

85 

55 



STA 

COLCRS 


4848 

F9D0 

68 




PLA 



4849 

F9D1 

85 

54 



STA 

ROWCRS 


4850 

F9D3 

60 




RTS 



4851 









4852 





; 




4853 





; INCREMENT 

CURSOR AND DETECT BOTH END OF LINE AND END OF SCREEN 

4854 





/ 




4855 

F9D4 

A9 

00 


INCRSB: 

LDA 

#0 

NON-EXTEND ENTRY POINT 

4856 

F9D6 

FO 

02 



BEG 

INCRSC 


4857 

F9D8 

A9 

9B 


INCRSR : 

LDA 

#$9B 

SPECIAL CASE ELIMINATOR 

4858 

F9DA 

85 

7D 


INCRSC: 

STA 

INSDAT 


4859 

F9DC 

E6 

63 


INCRSA: 

INC 

LOGCOL 

< INSCHR ENTRY POINT) 

4860 

F9DE 

E6 

55 



INC 

COLCRS 


4861 

F9E0 

DO 

02 



BNE 

INCRS2 

DO HIGH BYTE 

4862 

F9E2 

E6 

56 



INC 

COLCRS+1 


4863 

F9E4 

A5 

55 


INCRS2: 

LDA 

COLCRS 

TEST END OF LINE 

4864 

F9E6 

A6 

57 



LDX 

DINDEX 


4865 

F9E8 

DD 

8D 

FE 


CMP 

COLUMN/ X 

TEST TABLED VALUE FOR ALL SCREEN MODES 

4866 

F9EB 

FO 

OB 



BEG 

INC 2 A 

DO CR IF EQUAL 

4867 

F9ED 

EO 

00 



CPX 

#0 

MODE 0? 

4868 

F9EF 

DO 

06 



BNE 

INCRS3 

IF NOT, JUST RETURN 

4869 

F9F1 

C5 

53 



CMP 

RMARGN 

TEST AGAINST RMARGN 

4870 

F9F3 

FO 

02 



BEG 

INCRS3 

EQUAL IS OK 

4871 

F9F5 

BO 

01 



BCS 

INC 2 A 

IF GREATER THAN, DO CR 

4872 

F9F7 

60 



INCRS3: 

RTS 



4873 

F9F8 

EO 

08 


INC2A: 

CPX 

#8 

CHECK MODE 

4874 

F9FA 

90 

04 



BCC 

D0CR1 

NOT 320X1 SO DO IT 

4875 

F9FC 

A5 

56 



LDA 

COLCRS+1 

TEST MSD 

4876 

F9FE 

FO 

F7 



BEG 

INCRS3 

ONLY AT 64 SO DON'T DO IT 

4877 

FA00 

A5 

57 


D0CR1: 

LDA 

DINDEX 

DON'T MESS WITH LOGMAP IF NO MODE ZERO 

4878 

FA02 

DO 

30 



BNE 

DOCR 


4879 

FA04 

A5 

63 



LDA 

LOGCOL 

TEST LINE OVERRUN 

4880 

FA06 

C9 

51 



CMP 

#81 


4881 

FA08 

90 

OA 



BCC 

DOCR IB 

IF LESS THAN 81 IT IS DEFINITELY NOT LINE 

4882 

FAOA 

A5 

7D 



LDA 

INSDAT 


4883 

FAOC 

FO 

26 



BEG 

DOCR 

ONLY DO LOG LINE OVERFLOW IF INSDAT OO 

4884 

FAOE 

20 

30 

FA 


JSR 

DOCRWS 

LOG LINE OVERFLOW IS SPECIAL CASE 

4885 

FA1 1 

4C 

77 

FA 


JMP 

INCRS1 

RETURN 

4886 

FA14 

20 

34 

FA 

D0CR1B: 

JSR 

DOCR 

GET IT OVER WITH 

4887 

FA17 

A5 

54 



LDA 

ROWCRS 


4888 

FA19 

18 




CLC 


TEST LOGICAL LINE BIT MAP 

4889 

FA1 A 

69 

78 



ADC 

#120 


4890 

FA1C 

20 

25 

FB 


JSR 

BITGET 


4891 

FA1F 

90 

08 



BCC 

DOCR 1 A ; DON'T EXTEND IF OVERRUN IS INTO MIDDLE OF 

4892 

FA21 

A5 

7D 



LDA 

INSDAT 

DON'T EXTEND IF INSDAT IS ZERO 



ERR LINE 
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4893 

FA23 

FO 

04 



BEG 

DOCR 1 A 

4894 

FA25 

18 




CLC 


4895 

FA26 

20 

A5 

F8 


JSR 

INSLIA 

4896 

FA29 

4C 

DD 

FB 

DOCR 1 A: 

JMP 

DOLCOL 

4897 

FA2C 

A9 

00 


NOSCRL: 

LDA 

#0 

4898 

FA2E 

FO 

02 



BEG 

N0SCR1 

4899 

FA30 

A9 

9B 


DOCRWS: 

LDA 

#*9B 

4900 

FA32 

85 

7D 


N0SCR1: 

STA 

INSDAT 

4901 

FA34 

20 

E4 

FC 

DOCR: 

JSR 

COLCR 

4902 

FA37 

A9 

00 



LDA 

#0 

4903 

FA39 

85 

56 



STA 

COLCRS+1 

4904 

FA3B 

E6 

54 



INC 

ROWCRS 

4905 

FA3D 

A6 

57 


D0CR2: 

LDX 

DINDEX 

4906 

FA3F 

AO 

18 



LDY 

#24 

4907 

FA41 

24 

7B 



BIT 

SWPFLG 

4908 

FA43 

10 

05 



BPL 

D0CR2A 

4909 

FA45 

AO 

04 



LDY 

#4 

4910 

FA47 

98 




TYA 


4911 

FA48 

DO 

03 



BNE 

D0CR2B 

4912 

FA4A 

BD 

99 

FE 

DQCR2A: 

LDA 

NOROWS, X 

4913 

FA4D 

C5 

54 


D0CR2B: 

CMP 

ROWCRS 

4914 

FA4F 

DO 

26 



BNE 

INCRS1 

4915 

FA51 

8C 

9D 

02 


STY 

H0LD3 

4916 

FA54 

8A 




TXA 


4917 

FA55 

DO 

20 



BNE 

INCRS1 

4918 

FA57 

A5 

7D 



LDA 

INSDAT 

4919 

FA59 

FO 

1C 



BEG 

INCRS1 

4920 





{ 

LDA 

INSDAT 

4921 

FA5B 

C9 

9B 



CMP 

#*9B 

4922 

FA5D 

38 




SEC 


4923 

FA5E 

FO 

01 



BEG 

D0CR4B 

4924 

FA60 

18 




CLC 


4925 

FA61 

20 

AC 

FB 

D0CR4B : 

JSR 

SCROLL 

4926 

FA64 

EE 

BB 

02 


INC 

SCRFLG 

4927 

FA67 

C6 

6C 



DEC 

BUFSTR 

4928 

FA69 

CE 

9D 

02 


DEC 

H0LD3 

4929 

FA6C 

AD 

B2 

02 


LDA 

LOGMAP 

4930 

FA6F 

38 




SEC 


4931 

FA70 

10 

EF 



BPL 

D0CR4B 

4932 

FA72 

AD 

9D 

02 


LDA 

H0LD3 

4933 

FA75 

85 

54 



STA 

ROWCRS 

4934 

FA77 

4C 

DD 

FB 

INCRS1: 

JMP 

DOLCOL 

4935 





{ 



4936 





i 



4937 





; SUBEND: SUBTRACT ENDPT 

4938 





/ 



4939 

FA7A 

38 



SUBEND: 

SEC 


4940 

FA7B 

B5 

70 



LDA 

ROWAC, X 

4941 

FA7D 

E5 

74 



SBC 

ENDPT 

4942 

FA7F 

95 

70 



STA 

ROWAC, X. 

4943 

FA81 

B5 

71 



LDA 

ROWAC +1 , ; 

4944 

FA83 

E5 

75 



SBC 

ENDPT-*-! 

4945 

FA85 

95 

71 



STA 

ROWAC-*-!, : 

4946 

FA87 

60 




RTS 



78 
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i ( I NSC HR SPECIAL CASE) 

; INSERT "0" INTO BIT MAP 

; CONVERT ROW AND COL TO LOGCOL AND RETURN 
* DOCR WITHOUT SCROLL 
{ (UNCONDITIONAL) 

; DOCR WITH SCROLLING (NORMAL MODE) 

; PLACE COLCRS AT LEFT EDGE 


; SET UP SCROLL LOOP COUNTER 
; BRANCH IF NORMAL 


{ (UNCONDITIONAL) 
; GET NO OF ROWS 


{DON'T SCROLL IF MODE O 0 
iQR IF INSDAT = 0 

IF INSDAT <> *9B THEN ROLL IN A O 
; TO EXTEND BOTTOM LOGICAL LINE 


; LOOP BACK TO HERE IF >1 SCROLLS 
; ROWS MOVE UP SO BUFSTR SHOULD TOO 


; FOR PARTIAL LINES, ROLL IN A "l" 

.AGAIN IF PARTIAL LOGICAL LINE 
{ PLACE CURSOR AT NEW LINE NEAR THE BOTTOM 

{ COLVERT ROW AND COL TO LOGCOL AND RETURN 


ROWAC OR COLAC. ( X=0 OR 2) 
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4947 

4948 

4949 

4950 

4951 

4952 

4953 

FA88 

AD 

BF 

02 

4954 

FA8B 

C9 

04 


4955 

FA8D 

FO 

07 


4956 

FA8F 

A5 

57 


4957 

FA91 

FO 

03 


4958 

FA93 

20 

FC 

F3 

4959 

FA96 

A9 

27 


4960 

FA98 

C5 

53 


4961 

FA9A 

BO 

02 


4962 

FA9C 

85 

53 


4963 

FA9E 

A6 

57 


4964 

FA AO 

BD 

99 

FE 

4965 

FA A3 

*C5 

54 


4966 

FAA5 

90 

2A 


4967 

FAA7 

FO 

28 


4968 

FAA9 

EO 

08 


4969 

FAAB 

DO 

OA 


4970 

FAAD 

A5 

56 


4971 

FAAF 

FO 

13 


4972 

FAB1 

C9 

01 


4973 

FAB3 

DO 

1C 


4974 

FAB5 

FO 

04 


4975 

FAB7 

A5 

56 


4976 

FAB9 

DO 

16 


4977 

FABB 

BD 

8D 

FE 

4978 

FABE 

C5 

55 


4979 

FACO 

90 

OF 


4980 

FAC2 

FO 

OD 


4981 

FAC 4 

A9 

01 


4982 

FAC6 

85 

4C 


4983 

FAC8 

A9 

80 


4984 

FACA 

A6 

11 


4985 

FACC 

85 

11 


4986 

FACE 

FO 

06 


4987 

FADO 

60 



4988 

FAD1 

20 

D6 

F7 

4989 

FAD4 

A9 

8D 


4990 

FAD6 

85 

4C 


4991 

FADS 

68 



4992 

FAD9 

68 



4993 

FADA 

A5 

7B 


4994 

FADC 

10 

03 


4995 

FADE 

20 

B9 

FC 

4996 

4997 

4998 

4999 

5000 

FAE1 

4C 

34 

F6 


RANGE: DO CURSOR RANGE TEST. IF ERROR, POP STACK TWICE AND UMP RETURN 
(ERANGE IS EDITOR ENTRY POINT AND TEST IF EDITOR IS OPEN. 

IF IT ISNT IT OPENS THE EDITOR AND CONTINUES) 


ERANGE: LDA BOTSCR ; IF BQTSCR=4 

CMP #4 

BEQ RANGE ; THEN IT IS IN MIXED MODE AND OK 

LDA DINDEX ; IF MODE = 0 

BEQ RANGE ; THEN IT IS IN EDITOR MODE AND OK 

JSR EOPEN ; IF NOT, OPEN EDITOR 

RANGE: LDA #39 ;***** RANGE CHECK RMARGN ***** SET UP AC 

CMP RMARGN ; ***** RANGE CHECK RMARGN ***** COMPARE 

BCS RANGE3 ; ***** RANGE CHECK RMARGN ***** BRANCH GE 

STA RMARGN ; ***** RANGE CHECK RMARGN ***** BAD SO STORE 

RANGES: LDX DINDEX 

LDA NOROWS, X ; CHECK ROWS 

CMP ROWCRS 

BCC RNGERR ; (ERROR IF TABLE. GE. ROWCRS) 

BEQ RNGERR 

CPX #8 i CHECK FOR 320X1 

BNE RANGE 1 ; SPECIAL CASE IT 

LDA CQLCRS+1 

BEQ RNGOK ; IF HIGH BYTE IS 0, COL IS OK 

CMP #1 

BNE RNGERR ; IF >1, BAD 

BEQ RANGE2 i IF 1, GO CHECK LOW BYTE 

RANGE 1 : LDA COLCRS+1 ; FOR OTHERS, NON-ZERO HIGH BYTE IS BAD 

BNE RNGERR 

RANGE2: LDA COLUMN, X ; CHECK LOW BYTE 

CMP COLCRS 

BCC RNGERR 

BEQ RNGERR 

RNGOK: LDA #SUCCES ; SET STATUS OK 

STA DSTAT 

LDA #BRKABT ; PREPARE BREAK ABORT STATUS 

LDX BRKKEY ; CHECK BREAK KEY FLAG 

STA BRKKEY ; 'CLEAR' BREAK 

BEQ RNGER2 ; IF BREAK, QUIT IMMEDIATELY AND RETURN TO Cl 

RTS 

RNGERR: JSR HOME i ON RANGE ERROR, BRING CURSOR BACK 

LDA #CRSRQR ; SHOW CURSOR OVERRANGE ERROR 

RNGER2: STA DSTAT 

RNGER1 : PLA ; RESTORE STACK (THIS ROUTINE IS ALWAYS 1 LEV 

PLA ; AWAY FROM RETURN TO CIO) 

LDA SWPFLG ; IF SWAPPED, SWAP BACK 

BPL RETUR3 

JSR SWAPA ; AND DONT DO RETUR1 

RETUR3: JMP RETUR1 ; RETURN TO CIO 


OFFCRS: RESTORE OLD DATA UNDER CURSOR SO IT CAN BE MOVED 
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5001 









5002 

FAE4 

AO 

00 

OFFCRS: 

LDY 

#0 

5003 

FAE6 

A5 

5D 



LDA 

OLDCHR 

5004 

FAE8 

91 

5E 



STA 

(OLDADR), Y 

5005 

FAEA 

60 




RTS 


5006 









5007 









5008 









5009 





BITMAP 

ROUTINES: 

5010 









5011 





BITCON 

PUT 

MASK IN BITMSK AND INDEX IN X 

5012 





BITPUT 

PUT 

CARRY INTO BITMAP 

5013 





BITROL 

ROL 

CARRY INTO BOTTOM OF BITMAP (SCROLL) 

5014 





BITSET 

SET 

PROPER BIT 

5015 





BITCLR 

CLEAR PROPER BIT 

5016 





BITGET 

RETURN CARRY SET IF BIT IS THERE 

5017 





LOGGET 

DO BITGET FOR LOGMAP INSTEAD OF TABMAP 

5018 









5019 

FAEB 

48 


BITCON: 

PHA 


5020 

FAEC 

29 

07 



AND 

#7 

5021 

FAEE 

AA 




TAX 

; GET MASK 

5022 

FAEF 

BD 

B9 

FE 


LDA 

MASKTB, X 

5023 

FAF2 

85 

6E 



STA 

BITMSK 

5024 

FAF4 

68 




PLA 

; PROCESS INDEX 

5025 

FAF5 

4A 




LSR 

A 

5026 

FAF6 

4A 




LSR 

A 

5027 

FAF7 

4A 




LSR 

A 

5028 

FAF8 

AA 




TAX 


5029 

FAF9 

60 




RTS 


5030 









5031 









5032 

FAFA 

2E 

B4 

02 BITROL: 

ROL 

LOGMAP+2 

5033 

FAFD 

2E 

B3 

02 


ROL 

LOGMAP+1 

5034 

FB00 

2E 

B2 

02 


ROL 

LOGMAP 

5035 

FB03 

60 




RTS 


5036 









5037 









5038 

FB04 

90 

OC 

BITPUT: 

BCC 

BITCLR ; AND RETURN 

5039 





OTHERWISE FALL THROUGH TO BITSET AND RETURN 

5040 

FB06 

20 

EB 

FA BITSET: 

JSR 

BITCON 

5041 

FB09 

BD 

A3 

02 


LDA 

TABMAP i X 

5042 

FBOC 

05 

6E 



ORA 

BITMSK 

5043 

FBOE 

9D 

A3 

02 


STA 

TABMAP/ X 

5044 

FB11 

60 




RTS 


5045 









5046 

FB 12 

20 

EB 

FA BITCLR: 

JSR 

BITCON 

5047 

FBI 5 

A5 

6E 



LDA 

BITMSK 

5048 

FB 17 

49 

FF 



EOR 

#$FF 

5049 

FB 19 

3D 

A3 

02 


AND 

TABMAP, X 

5050 

FB 1C 

9D 

A3 

02 


STA 

TABMAP, X 

5051 

FB IF 

60 




RTS 


5052 









5053 

FB20 

A5 

54 

LOGGET: 

LDA 

ROWCRS 

5054 

FB22 

18 


L01GET: 

CLC 
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5055 

FB23 

69 

78 

L02GET: 

ADC 

#120 


5056 

FB25 

20 

EB 

FA BITGET: 

JSR 

BITCON 


5057 

FB28 

18 




CLC 



5058 

FB29 

BD 

A3 

02 


LDA 

TABMAP, X 


5059 

FB2C 

25 

6E 



AND 

BITMSK 


5060 

FB2E 

F0 

01 



BEG 

BITGE1 


5061 

FB30 

38 




SEC 



5062 

FB31 

60 


BITGE1 : 

RTS 



5063 

5064 

5065 

5066 









5067 





INATAC: INTERNAL (CHAR ) TO 

ATASCI I (ATACHR) CONVERSION 

5068 

5069 

FB32 

AD 

FA 

02 

INATAC: 

LDA 

CHAR 


5070 

FB35 

A4 

57 



LDY 

DINDEX 

i IF GRAPHICS MODES 

5071 

FB37 

CO 

03 



CPY 

#3 


5072 

FB39 

BO 

OF 



BCS 

I NAT A 1 

; THEN DON'T CHANGE CHAR 

5073 

FB3B 

2A 




ROL 

A 


5074 

FB3C 

2A 




ROL 

A 


5075 

FB3D 

2A 




ROL 

A 


5076 

FB3E 

2A 




ROL 

A 


5077 

FB3F 

29 

03 



AND 

#3 


5078 

FB41 

AA 




TAX 



5079 

FB42 

AD 

FA 

02 


LDA 

CHAR 


5080 

FB45 

29 

9F 



AND 

#*9F 


5081 

FB47 

ID 

FA 

FE 


ORA 

INTATA, X 


5082 

FB4A 

8D 

FB 

02 

INATA1 : 

STA 

ATACHR 


5083 

5084 

5085 

5086 

FB4D 

60 




RTS 



5087 





MOVLIN: MOVE 40 BYTES AT 

FRMADR TO TOADR SAVING OLD TOADR 

5088 






DATA 

IN THE LINBUF. 

THEN MAKE NEXT FRMADR 

5089 






BE AT 

LINBUF FOR NEXT TRANSFER & T0ADR=T0ADR+40 

5090 









5091 

FB4E 

A9 

02 

MOVLIN: 

LDA 

#LINBUF/256 

; SET UP ADRESS=LINBUF=*247 

5092 

FB50 

85 

65 



STA 

ADRESS+1 


5093 

FB52 

A9 

47 



LDA 

#LINBUF. AND. *FF 

5094 

FB54 

85 

64 



STA 

ADRESS 


5095 

FB56 

AO 

27 



LDY 

#39 


5096 

FB58 

B1 

66 

M0VLI1: 

LDA 

( TOADR > , Y 

; SAVE TO DATA 

5097 

FB5A 

85 

50 



STA 

TMPC HR 


5098 

FB5C 

B1 

68 



LDA 

( FRMADR > ' Y 

; STORE DATA 

5099 

FB5E 

91 

66 



STA 

( TOADR > , Y 


5100 

FB60 

A5 

50 



LDA 

TMPC HR 


5101 

FB62 

91 

64 



STA 

(ADRESS), Y 


5102 

FB64 

88 




DEY 



5103 

FB65 

10 

FI 



BPL 

M0VLI1 


5104 

FB67 

A5 

65 



LDA 

ADRESS+1 

; SET UP FRMADR=LAST LINE 

5105 

FB69 

85 

69 



STA 

FRMADR+1 


5106 

FB6B 

A5 

64 



LDA 

ADRESS 


5107 

FB6D 

85 

68 



STA 

FRMADR 


5108 

FB6F 

18 




CLC 


; ADD 40 TO TOADR 
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5109 

FB70 

A5 

66 



LDA 

TOADR 


5110 

FB72 

69 

28 



ADC 

#40 


5111 

FB74 

85 

66 



STA 

TOADR 


5112 

FB76 

90 

02 



BCC 

MQVLI2 


5113 

FB78 

E6 

67 



INC 

TOADR+1 


5114 

FB7A 

60 



M0VLI2: 

RTS 



5115 





i 




5116 





i 




5117 





■, 




5118 





; EXTEND: EXTEND BIT MAP FROM ROWCRS (EXTEND LOGICAL LINE 

5119 





# 




5120 

FB7B 

08 



EXTEND: 

PHP 


; SAVE CARRY 

5121 

FB7C 

AO 

17 



LDY 

#23 


5122 

FB7E 

98 



EXTENT. 

TYA 



5123 

FB7F 

20 

22 

FB 


JSR 

L01GET 


5124 

FB82 

08 




PHP 



5125 

FB83 

98 




TYA 



5126 

FB84 

18 




CLC 



5127 

FB85 

69 

79 



ADC 

#121 


5128 

FB87 

28 




PLP 



5129 

FB88 

20 

04 

FB 


JSR 

BITPUT 


5130 

FB8B 

88 



EXTEN3: 

DEY 



5131 

FB8C 

30 

04 



BMI 

EXTEN4 


5132 

FB8E 

C4 

54 



CP Y 

ROWCRS 


5133 

FB90 

BO 

EC 



BCS 

EXTEN1 


5134 

FB92 

A5 

54 


EXTEN4: 

LDA 

ROWCRS 


5135 

FB94 

18 




CLC 



5136 

FB95 

69 

78 



ADC 

#120 


5137 

FB97 

28 




PLP 



5138 

FB98 

4C 

04 

FB 


JMP 

BITPUT 

; STORE NEW LINE'S BIT AND RETURN 

5139 





> 




5140 





; 




5141 





/ 




5142 





; CLRLIN : CLEAR 

LINE CURSOR 

IS ON 

5143 





; 




5144 

FB9B 

A5 

52 


CLRLIN: 

LDA 

LMARGN 


5145 

FB9D 

85 

55 



STA 

COLCRS 


5146 

FB9F 

20 

47 

F9 


JSR 

CQNVRT 


5147 

FBA2 

AO 

27 



LDY 

#39 


5148 

FBA4 

A9 

00 



LDA 

#0 


5149 

FBA6 

91 

64 


CLRLI 1 : 

STA 

(ADRESS) , Y 


5150 

FBA8 

88 




DEY 



5151 

FBA9 

10 

FB 



BPL 

CLRLI 1 


5152 

FBAB 

60 




RTS 



5153 





; 




5154 





; 




5155 





; 




5156 





; 




5157 





i SCROLL: SCROLL SCREEN 


5158 





t 




5159 

FBAC 

20 

FA 

FA 

SCROLL: 

JSR 

BITROL 

; ROLL IN CARRY 

5160 

FBAF 

A5 

58 



LDA 

SAVMSC 

; SET UP WORKING REGISTERS 

5161 

FBB1 

85 

64 



STA 

ADRESS 


5162 

FBB3 

A5 

59 



LDA 

SAVMSC+i 
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5163 

FBB5 

85 

65 



STA 

ADRESS+1 



5164 

FBB7 

AO 

28 

SCR0L1 : 

LDY 

#40 

i LOOP 


5165 

FBB9 

B 1 

64 



LDA 

(ADRESS), Y 



5166 

FBBB 

A6 

6A 



LDX 

RAMTOP 

; TEST FOR LAST LINE 


5167 

FBBD 

CA 




DEX 




5168 

FBBE 

E4 

65 



CPX 

ADRESS+1 



5169 

FBCO 

DO 

08 



BNE 

SCR0L2 



5170 

FBC2 

A2 

D7 



LDX 

#*D7 



5171 

FBC4 

E4 

64 



CPX 

ADRESS 



5172 

FBC6 

BO 

02 



BCS 

SCR0L2 



5173 

FBC8 

A9 

00 



LDA 

#0 

; YES SO STORE ZERO DATA FOR THIS ENTIRE LINE 

5174 

FBCA 

AO 

00 

SCR0L2: 

LDY 

#0 



5175 

FBCC 

91 

64 



STA 

(ADRESS), Y 



5176 

FBCE 

E6 

64 



INC 

ADRESS 



5177 

FBDO 

DO 

E5 



BNE 

SCR0L1 



5178 

FBD2 

E6 

65 



INC 

ADRESS+1 



5179 

FBD4 

A5 

65 



LDA 

ADRESS+1 



5180 

FBD6 

C5 

6A 



CMP 

RAMTOP 



5181 

FBD8 

DO 

DD 



BNE 

SCR0L1 



5182 

FBDA 

4C 

DD 

FB 


JMP 

DOLCOL 

AND RETURN 


5183 










5184 










5185 





DOLCOL: DO 

LOGICAL COLUMN 

FROM BITMAP AND COLCRS 


5186 










5187 

FBDD 

A9 

00 

DOLCOL: 

LDA 

#0 

; START WITH ZERO 


5188 

FBDF 

85 

63 



STA 

LOGCOL 



5189 

FBE1 

A5 

54 



LDA 

ROWCRS 



5190 

FBE3 

85 

51 



STA 

H0LD1 



5191 

FBE5 

A5 

51 

D0LC01 : 

LDA 

H0LD1 

; ADD IN ROW COMPONENT 


5192 

FBE7 

20 

22 

FB 


JSR 

L01GET 



5193 

FBEA 

BO 

OC 



BCS 

D0LC02 

i FOUND BEGINNING OF LINE 


5194 

FBEC 

A5 

63 



LDA 

LOGCOL 

; ADD 40 AND LOOK BACK ONE 


5195 

FBEE 

18 




CLC 




5196 

FBEF 

69 

28 



ADC 

#40 



5197 

FBF1 

85 

63 



STA 

LOGCOL 



5198 

FBF3 

C6 

51 



DEC 

H0LD1 

; UP ONE LINE 


5199 

FBF5 

4C 

E5 

FB 


JMP 

D0LC01 



5200 

FBF8 

18 


D0LC02: 

CLC 


; ADD IN COLCRS 


5201 

FBF9 

A5 

63 



LDA 

LOGCOL 



5202 

FBFB 

65 

55 



ADC 

COLCRS 



5203 

FBFD 

85 

63 



STA 

LOGCOL 



5204 

FBFF 

60 




RTS 




5205 










5206 










5207 










5208 





DOBUFC: COMPUTE BUFFER COUNT AS THE NUMBER OF BYTES 

FROM 

5209 





: 

BUFSTR TO END OF 

LOGICAL LINE WITH TRAILING 

SPACES REMOVED 

5210 










5211 

FCOO 

20 

9D 

FC DOBUFC : 

JSR 

PHACRS 



5212 

FC03 

A5 

63 



LDA 

LOGCOL 



5213 

FC05 

48 




PHA 




5214 

FC06 

A5 

6C 



LDA 

BUFSTR 

; START 


5215 

FC08 

85 

54 



STA 

ROWCRS 



5216 

FCOA 

A5 

6D 



LDA 

BUFSTR+1 
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5217 

FCOC 

85 

55 



STA 

COLCRS 


5218 

FCOE 

A9 

01 



LDA 

#1 


5219 

FC 10 

85 

6B 



STA 

BUFCNT 


5220 

FC 12 

A2 

17 

D0BUF1: 

LDX 

#23 

; NORMAL 

5221 

FC 14 

A5 

7B 



LDA 

SWPFLG 

; IF SWAPPED, ROW 3 IS THE LAST LINE ON SCREE 

5222 

FC 16 

10 

02 



BPL 

DOB 1 


5223 

FC 18 

A2 

03 



LDX 

#3 


5224 

FC 1 A 

E4 

54 

DOB 1 : 

CPX 

RQWCRS 

; TEST IF CRSR IS AT LAST SCREEN POSITION 

5225 

FC 1C 

DO 

OB 



BNE 

D0BU1A 


5226 

FC IE 

A5 

55 



LDA 

COLCRS 


5227 

FC20 

C5 

53 



CMP 

RMARGN 


5228 

FC22 

DO 

05 



BNE 

D0BU1A 


5229 

FC24 

E6 

6B 



INC 

BUFCNT 

; YES, SO FAKE INCRSR TO AVOID SCROLLING 

5230 

FC26 

4C 

39 

FC 


JMP 

D0BUF2 


5231 

FC29 

20 

D4 

F9 D0BU1A: 

JSR 

I NCR SB 


5232 

FC2C 

E6 

6B 



INC 

BUFCNT 


5233 

FC2E 

A5 

63 



LDA 

LOGCOL 


5234 

FC30 

C5 

52 



CMP 

LMARGN 


5235 

FC32 

DO 

DE 



BNE 

D0BUF1 

; NOT YET EOL 

5236 

FC34 

C6 

54 



DEC 

RQWCRS 

; BACK UP ONE INCRSR 

5237 

FC36 

20 

99 

F7 


JSR 

CRSRLF 


5238 

FC39 

20 

A2 

F5 D0BUF2: 

JSR 

GETPLT 

; TEST CURRENT COLUMN FOR NON-ZERO DATA 

5239 

FC3C 

DO 

17 



BNE 

D0BUF4 

; QUIT IF NON-ZERO 

5240 

FC3E 

C6 

6B 



DEC 

BUFCNT 

; DECREMENT COUNTER 

5241 

FC40 

A5 

63 



LDA 

LOGCOL 

i BEGINNING OF LOGICAL LINE YET? 

5242 

FC42 

C5 

52 



CMP 

LMARGN 


5243 

FC44 

FO 

OF 



BEG 

DQBUF4 

i YES, SO QUIT 

5244 

FC46 

20 

99 

F7 


JSR 

CRSRLF 

; BACK UP CURSOR 

5245 

FC49 

A5 

55 



LDA 

COLCRS 

; IF LOGCOL =RMARGN, GO UP 1 ROW 

5246 

FC4B 

C5 

53 



CMP 

RMARGN 


5247 

FC4D 

DO 

02 



BNE 

D0BUF3 


5248 

FC4F 

C6 

54 



DEC 

RQWCRS 


5249 

FC51 

A5 

6B 

D0BUF3: 

LDA 

BUFCNT 


5250 

FC 53 

DO 

E4 



BNE 

D0BUF2 

; LOOP UNLESS BUFCNT JUST WENT TO ZERO 

5251 

FC 55 

68 


D0BUF4: 

PLA 



5252 

FC56 

85 

63 



STA 

LOGCOL 


5253 

FC58 

20 

A8 

FC 


JSR 

PLACRS 


5254 

FC5B 

60 




RTS 



5255 









5256 









5257 









5258 









5259 





STRBEG: MOVE 

BUFSTR TO 

BEGINNING OF LOGICAL LINE. 

5260 









5261 

FC5C 

20 

DD 

FB STRBEG: 

JSR 

DOLCOL 

« USE DOLCOL TO POINT H0LD1 AT BOL 

5262 

FC5F 

A5 

51 



LDA 

H0LD1 


5263 

FC61 

85 

6C 



STA 

BUFSTR 


5264 

FC63 

A5 

52 



LDA 

LMARGN 


5265 

FC65 

85 

6D 



STA 

BUFSTR+1 


5266 

FC67 

60 




RTS 



5267 









5268 









5269 









5270 
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5272 





DELTIM: TIME 

TO DELETE 

A 

LINE IF IT IS EMPTY AND AN EXTENSION 

5273 










5274 

FC68 

A5 

63 

DELTIA 

LDA 

LOGCQL 


i IF LOGCQLOLMARGN 

5275 

FC6A 

C5 

52 



CMP 

LMARGN 


; THEN DONT MOVE UP ONE 

5276 

FC6C 

DO 

02 



BNE 

DELTIB 


; LINE BEFORE TESTING DELTIM 

5277 

FC6E 

C6 

54 



DEC 

ROWCRS 



5278 

FC70 

20 

DD 

FB DELTIB 

JSR 

DOLCOL 



5279 

FC73 

A5 

63 

DELTIM 

LDA 

LOGCOL 


; TEST FOR EXTENSION 

5280 

FC75 

C 5 

52 



CMP 

LMARGN 



5281 

FC77 

FO 

13 



BEG 

DELTI3 


; NO 

5282 

FC79 

20 

47 

F9 


JSR 

CONVRT 



5283 

FC7C 

A5 

53 



LDA 

RMARGN 


; SET UP COUNT 

5284 

FC7E 

38 




SEC 




5285 

FC7F 

E5 

52 



SBC 

LMARGN 



5286 

FC81 

A8 




TAY 




5287 

FC82 

B 1 

64 

DELHI 

LDA 

(ADRESS) 

, Y 


5288 

FC84 

DO 

06 



BNE 

DELTI3 


i FOUND A NON-O SO QUIT AND RETURN 

5289 

FC86 

88 




DEY 




5290 

FC87 

10 

F9 



BPL 

DELTI1 



5291 

FC89 

4C 

DB 

F8 DELTI2- 

JMP 

DELL IB 


; DELETE A LINE AND RETURN 

5292 

FC8C 

60 


DELTI3 

RTS 




5293 

5294 

5295 










5296 





TSTCTL: SEARCH CNTRLS 

TABLE TO SEE IF ATACHR IS A CNTL CHAR 

5297 










5298 

FC8D 

A2 

2D 

TSTCTL: 

LDX 

#45 


i PREPARE TO SEARCH TABLE 

5299 

FC8F 

BD 

C6 

FE TSTCT1 

LDA 

CNTRLS, X 



5300 

FC92 

CD 

FB 

02 


CMP 

ATACHR 



5301 

FC95 

FO 

05 



BEG 

TSTCT2 



5302 

FC97 

CA 




DEX 




5303 

FC98 

CA 




DEX 




5304 

FC99 

CA 




DEX 




5305 

FC9A 

10 

F3 



BPL 

TSTCT1 



5306 

FC9C 

60 


TSTCT2: 

RTS 




5307 

5308 

5309 










5310 





PUSH 

ROWCRS, COLORS AND 

COLCRS+1 

5311 










5312 

FC9D 

A2 

02 

PHACRS: 

LDX 

#2 



5313 

FC9F 

B5 

54 

PHACR1: 

LDA 

ROWCRS, X 



5314 

FCA1 

9D 

B8 

02 


STA 

TMPROW, X 



5315 

FCA4 

CA 




DEX 




5316 

FCA5 

10 

F8 



BPL 

PHACR1 



5317 

5318 

5319 

FCA7 

60 




RTS 




5320 





PULL 

COLCRS+1 

, COLORS AND 

ROWCRS 

5321 










5322 

FCA8 

A2 

02 

PLACRS: 

LDX 

#2 



5323 

FCAA 

BD 

B8 

02 PLACR1 : 

LDA 

TMPROW, X 



5324 

FCAD 

95 

54 



STA 

ROWCRS, X 
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5325 

FCAF 

CA 



5326 

FCBO 

10 

F8 


5327 

5328 

5329 

5330 

FCB2 

60 



5331 

5332 

5333 

FCB3 

20 

B9 

FC 

5334 

FCB6 

4C 

34 

F6 

5335 

FCB9 

AD 

BF 

02 

5336 

FCBC 

C9 

18 


5337 

FCBE 

FO 

17 


5338 

FCCO 

A2 

OB 


5339 

FCC2 

B5 

54 


5340 

FCC4 

48 



5341 

FCC5 

BD 

90 

02 

5342 

FCC8 

95 

54 


5343 

FCCA 

68 



5344 

FCCB 

9D 

90 

02 

5345 

FCCE 

CA 



5346 

FCCF 

10 

FI 


5347 

FCD1 

A5 

7B 


5348 

FCD3 

49 

FF 


5349 

FCD5 

85 

7B 


5350 

FCD7 

60 



5351 

5352 

5353 

5354 

5355 

FCD8 

A2 

7F 


5356 

FCDA 

8E 

IF 

DO 

5357 

FCDD 

8E 

OA 

D4 

5358 

FCEO 

CA 



5359 

FCE1 

10 

F7 


5360 

5361 

5362 

5363 

FCE3 

60 



5364 

5365 

FCE4 

A9 

00 


5366 

FCE6 

A6 

7B 


5367 

FCE8 

DO 

04 


5368 

FCEA 

A6 

57 


5369 

FCEC 

DO 

02 


5370 

FCEE 

A5 

52 


5371 

FCFO 

85 

55 


5372 

5373 

5374 

5375 

5376 

FCF2 

60 



5377 

FCF3 

A5 

58 


5378 

FCF5 

85 

64 




DEX 




BPL 

PLACR1 



RTS 



i SWAP: 

IF MIXED MODE, SWAP TEXT CURSORS WITH 

REGULAR CURSORS 

SWAP: 

JSR 

SWAPA ; THIS ENTRY POINT 

DOES RETUR1 


JMP 

RETUR1 


SWAP A: 

LDA 

BOTSCR 



CMP 

#24 



BEQ 

SWAP3 



LDX 

'#11 


SWAP 1 : 

LDA 

ROWCRS, X 



PHA 




LDA 

TXTROWr X 



STA 

ROWCRS, X 



PLA 




STA 

TXTROW, X 



DEX 




BPL 

SWAP! 



LDA 

SWPFLG 



EOR 

#*FF 



STA 

SWPFLG 


SWAP3: 

RTS 




; CLICK: MAKE CLICK THROUGH KEYBOARD SPEAKER 

CLICK: LDX #*7F 

CLICK1 : STX CONSOL 

STX WSYNC 

DEX 

BPL CLICK1 

RTS 


COLCR : PUTS EITHER 0 OR LMARGN INTO COLCRS BASED ON MODE AND SWPFLG 


COLCR: 

LDA 

#0 


LDX 

SWPFLG 


BNE 

COLCR 1 


LDX 

DINDEX 


BNE 

C0LCR2 

COLCR 1: 

LDA 

LMARGN 

C0LCR2: 

STA 

COLCRS 


RTS 



; PUTMSC : PUT SAVMSC INTO ADRESS 

PUTMSC : LDA SAVMSC ; SET UP ADDRESS 

STA ADRESS 
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5379 

FCF7 

A5 

59 

LDA 

SAVMSC+1 

5380 

FCF9 

85 

65 

STA 

ADRESS+1 

5381 

FCFB 

60 


RTS 


5382 




/ 
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5383 . PAGE 

5384 ; 

5385 ; 

5386 i DRAW — DRAW A LINE FROM OLDROW, OLDCOL TO NEWROW, NEWCOL 

5387 ; (THE AL MILLER METHOD FROM BASKETBALL) 


5388 

FCFC 

A2 

00 

DRAW: 

LDX 

5389 

FCFE 

A5 

22 


LDA 

5390 

FDOO 

C9 

11 


CMP 

5391 

FD02 

FO 

08 


BEQ 

5392 

FD04 

C9 

12 


CMP 

5393 

FD06 

FO 

03 


BEQ 

5394 

FD08 

AO 

84 


LDY 

5395 

FDOA 

60 



RTS 

5396 

FDOB 

E8 


DRAWB : 

INX 

5397 

FDOC 

8E 

B7 02 

DRAWA: 

STX 

5398 

FDOF 

A5 

54 


LDA 

5399 

FD1 1 

85 

60 


STA 

5400 

FD13 

A5 

55 


LDA 

5401 

FD1 5 

85 

61 


STA 

5402 

FD17 

A5 

56 


LDA 

5403 

FD19 

85 

62 


STA 

5404 

FD1B 

A9 

01 


LDA 

5405 

FD1D 

85 

79 


STA 

5406 

FD1F 

85 

7A 


STA 

5407 

FD21 

38 



SEC 

5408 

FD22 

A5 

60 


LDA 

5409 

FD24 

E5 

5A 


SBC 

5410 

FD26 

85 

76 


STA 

5411 

FD28 

BO 

OD 


BCS 

5412 

FD2A 

A9 

FF 


LDA 

5413 

FD2C 

85 

79 


STA 

5414 

FD2E 

A5 

76 


LDA 

5415 

FD30 

49 

FF 


EOR 

5416 

FD32 

18 



CLC 

5417 

FD33 

69 

01 


ADC 

5418 

FD35 

85 

76 


STA 

5419 

FD37 

38 


DRAW1 : 

SEC 

5420 

FD38 

A5 

61 


LDA 

5421 

FD3A 

E5 

5B 


SBC 

5422 

FD3C 

85 

77 


STA 

5423 

FD3E 

A5 

62 


LDA 

5424 

FD40 

E5 

5C 


SBC 

5425 

FD42 

85 

78 


STA 

5426 

FD44 

BO 

16 


BCS 

5427 

FD46 

A9 

FF 


LDA 

5428 

FD48 

85 

7A 


STA 

5429 

FD4A 

A5 

77 


LDA 

5430 

FD4C 

49 

FF 


EOR 

5431 

FD4E 

85 

77 


STA 

5432 

FD50 

A5 

78 


LDA 

5433 

FD52 

49 

FF 


EOR 

5434 

FD54 

85 

78 


STA 

5435 

FD56 

E6 

77 


INC 

5436 

FD58 

DO 

02 


BNE 


#0 

ICCOMZ > TEST COMMAND: $11=DRAW $12=FILL 

#$11 
DRAWA 

#$12 i TEST FILL 

DRAWB ; YES 

#NVALID ,N0, SO RETURN INVALID COMMAND 


FILFLG 

ROWCRS ; PUT CURSOR INTO NEWROW, NEWCOL 

NEWROW 
COLCRS 
NEWCOL 
COLCRS+1 
NEWCQL+1 
#1 

ROWINC ; SET UP INITIAL DIRECTIONS 

COLINC 

NEWROW ; DETERMINE DELTA ROW 

OLDROW 

DELTAR 

DRAW! ; DO DIRECTION AND ABSOLUTE VALUE 

#$FF i BORROW WAS ATTEMPTED 

ROWINC ; SET DIRECT I DN=DOWN 

DELTAR 

#$FF ; DELTAR = ! DELTAR ! 

#1 

DELTAR 

NEWCOL ; NOW DELTA COLUMN 

OLDCOL 

DELTAC 

NEWCOL+1 ; TWO-BYTE QUANTITY 

OLDCOL+1 

DELTAC+1 

DRAW2 ; DIRECTION AND ABSOLUTE VALUE 

#$FF ; BORROW WAS ATTEMPTED 

COLINC ; SET DIRECTION = LEFT 

DELTAC 

#$FF ; DELTAC = I DELTAC i 

DELTAC 

DELTAC+1 

#$FF 

DELTAC+ 1 

DELTAC ; ADD ONE FOR TWOS COMPLEMENT 

DRAW2 
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5437 

FD5A 

E6 

78 



INC 

DELTAC+1 


5438 

FD5C 

A2 

02 


DRAW2: 

LDX 

#2 

; ZERO RAM FOR DRAW LOOP 

5439 

FD5E 

AO 

00 



LDY 

#0 


5440 

FD60 

84 

73 



STY 

COLAC+1 


5441 

FD62 

98 



DRAW3A: 

TYA 



5442 

FD63 

95 

70 



STA 

RGWAC < X 


5443 

FD65 

B5 

5A 



LDA 

OLDROW, X 


5444 

FD67 

95 

54 



STA 

ROWCRS, X 


5445 

FD69 

CA 




DEX 



5446 

FD6A 

10 

F6 



BPL 

DRAW3A 


5447 

FD6C 

A5 

77 



LDA 

DELTAC 

FIND LARGER ONE (ROW OR COL) 

5448 





/ 

STA 

COUNTR 

(PREPARE COUNTR AND ENDPT) 

5449 





/ 

STA 

ENDPT 


5450 

FD6E 

E8 




INX 


MAKE X 0 

5451 

FD6F 

A8 




TAY 



5452 

FD70 

A5 

78 



LDA 

DELTAC+1 


5453 

FD72 

85 

7F 



STA 

COUNTR+ 1 


5454 

FD74 

85 

75 



STA 

ENDPT+1 


5455 

FD76 

DO 

OB 



BNE 

DRAW3 

AUTOMATICALLY LARGER IF MSD>0 

5456 

FD78 

A5 

77 



LDA 

DELTAC 


5457 

FD7A 

C5 

76 



CMP 

DELTAR 

LOW COL >LOW ROW? 

5458 

FD7C 

BO 

05 



BCS 

DRAW3 

YES 

5459 

FD7E 

A5 

76 



LDA 

DELTAR 


5460 

FD80 

A2 

02 



LDX 

#2 


5461 

FD82 

AS 




TAY 



5462 

FD83 

98 



DRAW3: 

TYA 


PUT IN INITIAL CONDITIONS 

5463 

FD84 

85 

7E 



STA 

COUNTR 


5464 

FD86 

85 

74 



STA 

ENDPT 


5465 

FD88 

48 




PHA 


SAVE AC 

5466 

FD89 

A5 

75 



LDA 

ENDPT+1 

PUT LSB OF HIGH BYTE 

5467 

FD8B 

4A 




LSR 

A 

INTO CARRY 

5468 

FD8C 

68 




PLA 


RESTORE AC 

5469 

FD8D 

6A 




ROR 

A 

ROR THE 9 BIT ACUMULATOR 

5470 

FD8E 

95 

70 



STA 

ROWACi X 


5471 

FD90 

A5 

7E 


DRAW4A: 

LDA 

COUNTR 

TEST ZERO 

5472 

FD92 

05 

7F 



ORA 

COUNTR+1 


5473 

FD94 

DO 

03 



BNE 

DRAWU 

IF COUNTER IS ZERO* LEAVE DRAW 

5474 

FD96 

4C 

42 

FE 


JMP 

DR AW 10 


5475 

FD99 

18 



DRAW11: 

CLC 


ADD ROW TO ROWAC (PLOT LOOP) 

5476 

FD9A 

A5 

70 



LDA 

ROWAC 


5477 

FD9C 

65 

76 



ADC 

DELTAR 


5478 

FD9E 

85 

70 



STA 

ROWAC 


5479 

FDAO 

90 

02 



BCC 

DRAW5 


5480 

FDA2 

E6 

71 



INC 

ROWAC+1 


5481 

FDA4 

A5 

71 


DRAW5: 

LDA 

ROWAC +1 

COMPARE ROW TO ENDPOINT 

5482 

FDA6 

C5 

75 



CMP 

ENDPT+1 

IF HIGH BYTE OF ROW IS . LT. HIGH 

5483 

FDA8 

90 

14 



BCC 

DRAW6 

BYTE OF ENDPT, BLT TO COLUMN 

5484 

FDAA 

DO 

06 



BNE 

DRAW5A 


5485 

FDAC 

A5 

70 



LDA 

ROWAC 


5486 

FDAE 

G5 

74 



CMP 

ENDPT 

LOW BYTE 

5487 

FDBO 

90 

OC 



BCC 

DRAW6 

ALSO BLT 

5488 

FDB2 

18 



DRAW5A: 

CLC 


GE SO MOVE POINT 

5489 

FDB3 

A5 

54 



LDA 

ROWCRS 


5490 

FOBS 

65 

79 



ADC 

ROW INC 
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5491 

FDB7 

85 

54 



STA 

RQWCRS 


5492 

FDB9 

A2 

00 



LDX 

#0 

; AND SUBTRACT ENDPT FROM ROWAC 

5493 

FDBB 

20 

7A 

FA 


JSR 

SUBEND 


5494 

FDBE 

18 



DRAW6: 

CLC 


; DO SAME FOR COLUMN < DOUBLE BYTE ADD) 

5495 

FDBF 

A5 

72 



LDA 

COL AC 

; ADD 

5496 

FDC 1 

65 

77 



ADC 

DELTAC 


5497 

FDC3 

85 

72 



STA 

COL AC 


5498 

FDC 5 

A5 

73 



LDA 

CQLAC+1 


5499 

FDC7 

65 

78 



ADC 

DELTAC +1 


5500 

FDC9 

85 

73 



STA 

CQLAC+1 


5501 

FDCB 

C5 

75 



CMP 

ENDPT+1 

; COMPARE HIGH BYTE 

5502 

FDCD 

90 

27 



BCC 

DRAW8 


5503 

FDCF 

DO 

06 



BNE 

DRAW6A 


5504 

FDD1 

A5 

72 



LDA 

COLAC 

; COMPARE LOW BYTE 

5505 

FDD3 

C5 

74 



CMP 

ENDPT 


5506 

FDD5 

90 

IF 



BCC 

DRAWS 


5507 

FDD7 

24 

7A 


DRAW6A: 

BIT 

COLINC 

;+ OR - ? 

5508 

FDD9 

10 

10 



BPL 

DRAW6B 


5509 

FDDB 

C6 

55 



DEC 

COLCRS 

; DO DOUBLE BYTE DECREMENT 

5510 

FDDD 

A5 

55 



LDA 

COLCRS 


5511 

FDDF 

C9 

FF 



CMP 

#*FF 


5512 

FDE1 

DO 

OE 



BNE 

DRAW7 


5513 

FDE3 

A5 

56 



LDA 

COLCRS+1 


5514 

FDE5 

FO 

OA 



BEG 

DRAW7 

; DON'T DEC IF ZERO 

5515 

FDE7 

C6 

56 



DEC 

COLCRS+1 


5516 

FDE9 

10 

06 



BPL 

DRAW7 

; (UNCONDITIONAL) 

5517 

FDEB 

E6 

55 


DRAW6B: 

INC 

COLCRS 

; DO DOUBLE BYTE INCREMENT 

5518 

FDED 

DO 

02 



BNE 

DRAW7 


5519 

FDEF 

E6 

56 



INC 

COLCRS+1 


5520 

FDF1 

A2 

02 


DRAW7 : 

LDX 

#2 

; AND SUBTRACT ENDPT FROM COLAC 

5521 

FDF3 

20 

7A 

FA 


JSR 

SUBEND 


5522 

FDF6 

20 

96 

FA 

DRAW8: 

JSR 

RANGE 


5523 

FDF9 

20 

EO 

F5 


JSR 

OUTPLT 

; PLOT POINT 

5524 

FDFC 

AD 

B7 

02 


LDA 

FILFLG 

; TEST RIGHT FILL 

5525 

FDFF 

FO 

2F 



BEG 

DRAW9 


5526 

FE01 

20 

9D 

FC 


JSR 

PHACRS 


5527 

FE04 

AD 

FB 

02 


LDA 

ATACHR 


5528 

FE07 

8D 

BC 

02 


STA 

H0LD4 


5529 

FEOA 

A5 

54 


DRAWS A: 

LDA 

ROWCRS 

; SAVE ROW IN CASE OF CR 

5530 

FEOC 

48 




PHA 



5531 

FEOD 

20 

DC 

F9 


JSR 

INCRSA 

; POSITION CURSOR ONE PAST DOT 

5532 

FE10 

68 




PLA 


; RESTORE ROWCRS 

5533 

FE1 1 

85 

54 



STA 

ROWCRS 


5534 

FE13 

20 

96 

FA 

DRAW8C : 

JSR 

RANGE 


5535 

FE16 

20 

A2 

F5 


JSR 

GETPLT 

i GET DATA 

5536 

FE 19 

DO 

OC 



BNE 

DRAW8B 

; STOP IF NON-ZERO DATA IS ENCOUNTERED 

5537 

FE1B 

AD 

FD 

02 


LDA 

FILDAT 

; FILL DATA 

5538 

FE1E 

8D 

FB 

02 


STA 

ATACHR 


5539 

FE21 

20 

EO 

F5 


JSR 

OUTPLT 

; DRAW IT 

5540 

FE24 

4C 

OA 

FE 


JMP 

DRAW8A 

; LOOP 

5541 

FE27 

AD 

BC 

02 

DRAW8B : 

LDA 

H0LD4 


5542 

FE2A 

8D 

FB 

02 


STA 

ATACHR 


5543 

FE2D 

20 

A8 

FC 


JSR 

PLACRS 


5544 

FE30 

38 



DRAW9: 

SEC 


; DO DOUBLE BYTE SUBTRACT 


122 
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5545 

FE31 

A5 

7E 


LDA 

COUNTR 


5546 

FE33 

E9 

01 


SBC 

41 


5547 

FE35 

85 

7E 


STA 

COUNTR 


5548 

FE37 

A5 

7F 


LDA 

CQUNTR+1 


554? 

FE3? 

E9 

00 


SBC 

#0 


5550 

FE3B 

85 

7F 


STA 

COUNTR+1 


5551 

FE3D 

30 

03 


BMI 

DRAW10 


5552 

FE3F 

4C 

90 

FD 

JMP 

DRAW4A 


5553 

FE42 

4C 

34 

F6 

DRAW 10: JMP 

RETUR1 
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5554 

5555 

5556 

5557 

5558 

5559 

5560 

5561 

5562 FE45 18 10 0A OA 

5563 FE49 10 1C 34 64 

5564 FE4D C4 04 C4 C4 

5565 

5566 

5567 

5568 

5569 FE51 17 17 OB 17 

5570 FE55 2F 2F 5F 5F 

5571 FE59 61 61 61 61 

5572 FE5D 13 13 09 13 

5573 FE61 27 27 4F 4F 

5574 FE65 41 41 41 41 

5575 

5576 

5577 

5578 

5579 

5580 

5581 

5582 

5583 

5584 

5585 

5586 

5587 

5588 

5589 

5590 

5591 

5592 

5593 FE69 02 06 07 08 

5594 FE6D 09 OA OB OD 

5595 FE71 OF OF OF OF 

5596 

5597 

5598 

5599 

5600 

5601 FE75 00 00 00 00 

5602 FE79 00 00 00 01 

5603 FE7D 01 01 01 01 

5604 

5605 

5606 

5607 


. PAGE 

; TABLES 

; MEMORY ALLOCATION 

ALOCAT: . BYTE 24/ 16, 10, 10, 16, 28, 52, 100, 196, 196, 196, 196 


; NUMBER OF DISPLAY LIST ENTRIES 

NUMDLE: .BYTE 23,23,11,23,47,47,95,95,97,97,97,97 

MXDMDE: .BYTE 19,19,9,19,39,39,79,79,65,65,65,65 ;<EXT OF NUMDLE) 


; ANTIC 

CODE FROM 

INTERNAL 

MODE 

CONVERSION TABLE 

; INTERNAL 

ANTIC 

CODE 

DESCRIPTION 


0 

2 


40X2X8 CHARACTERS 


1 

6 


20X5X8 


2 

7 


20X5X16 


3 

8 


40X4X8 GRAPHICS 


4 

9 


80X2X4 


5 

A 


80X4X4 


6 

B 


160X2X2 


7 

D 


160X4X2 


8 

F 


320X2X1 


9 

SAME AS 

8 BUT GTI A 'LUM' MODE 


10 

SAME AS 

8 BUT GTI A 'COL/LUM REGISTER ' MODE 


11 

SAME AS 

8 BUT GTIA 'COLOR ' MODE 

ANCONV: 

. BYTE 2, 

6, 7, 8, 9, 

*A, *B, 

*D, *F, *F, *F, *F ; ZEROS FOR RANGE TEST 


; PAGE TABLE TELLS WHICH DISPLAY LISTS ARE IN DANGER OF 
i CROSSING A 256 BYTE PAGE BOUNDARY 

PAGETB: .BYTE 0, 0, 0, 0, 0, 0, 0, 1 , 1 , 1 , 1 , 1 


THIS IS THE NUMBER OF LEFT SHIFTS NEEDED TO MULTIPLY 
COLCRS BY 10,20, OR 40. ( ROWCRS* 10 ) /.< 2**DHLINE ) 
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5608 

5609 FE81 02 01 01 00 

5610 FE85 00 01 01 02 

5611 FE89 02 02 02 02 

5612 

5613 

5614 

5615 

5616 FE8D 28 14 14 28 

5617 FE91 50 50 AO AO 

5618 FE95 40 50 50 50 

5619 

5620 

5621 

5622 

5623 

5624 FE99 18 18 OC 18 

5625 FE9D 30 30 60 60 

5626 FEA1 CO CO CO CO 

5627 

5628 

5629 

5630 

5631 

5632 

5633 FEA5 00 00 00 02 

5634 FEA9 03 02 03 02 

5635 FEAD 03 01 01 01 

5636 

5637 

5638 

5639 

5640 FEB1 00 FF FO OF 

5641 FEB5 CO 30 OC 03 

5642 

5643 

5644 

5645 FEB9 80 40 20 10 

5646 FEBD 08 04 02 01 

5647 

5648 

5649 

5650 

5651 FECI 28 CA 94 46 

5652 FEC5 00 

5653 

5654 

5655 

5656 

5657 

5658 

5659 

5660 FEC6 IB 

5661 FEC7 79 F7 


DHLINE: .BYTE 2, 1 , 1 , 0, O, 1 , 1 , 2, 2, 2, 2, 2 

; COLUMN: NUMBER OF COLUMNS 

COLUMN: .BYTE 40,20,20,40,80/80,160,160,64,80,80,80 ; MODE 8 IS SPECIAL 

; NOROWS: NUMBER OF ROWS 

NOROWS: .BYTE 24,24,12,24,48,48,96,96,192,192,192,192 


; DIV2TB: HOW MANY RIGHT SHIFTS FOR HCRSR FOR PARTIAL BYTE MODES 
DIV2TB: .BYTE 0, 0, 0, 2, 3, 2, 3, 2, 3, 1 , 1 , 1 

; DMASKT: DISPLAY MASK TABLE 

DMASKT: . BYTE *00, *FF, *F0, *GF 

. BYTE *C0, *30, *0C, *03 

; MASKTB : BIT MASK. (ALSO PART OF DMASKTB ! DO NOT SEPARATE) 

MASKTB: *. BYTE *80, *40, *20, *10, *08, *04, *02, *01 

i 

i 

i 

COLRTB: .BYTE *28, *C A, *94, *46, *00 

,- CNTRLS: CONTROL CODES AND THEIR DISPLACEMENTS INTO THE 
; CONTROL CHARACTER PROCESSORS 

CNTRLS: . BYTE *1B 

. WORD ESCAPE 
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5662 

FEC9 

1C 




. BYTE 

$1C 

5663 

FECA 

7F 

F7 



. WORD 

CRSRUP 

5664 

FECC 

ID 




. BYTE 

$1D 

5665 

FECD 

8C 

F7 



. WORD 

CRSRDN 

5666 

FECF 

IE 




. BYTE 

$1E 

5667 

FEDO 

99 

F7 



. WORD 

CRSRLF 

5668 

FED2 

IF 




. BYTE 

$1F 

5669 

FED3 

AA 

F7 



. WORD 

CRSRRT 

5670 

FEDS 

7D 




. BYTE 

$7D 

5671 

FED6 

B9 

F7 



. WORD 

CLRSCR 

5672 

FED8 

7E 




. BYTE 

$7E 

5673 

FED9 

E6 

F7 



. WORD 

BS 

5674 

FEDB 

7F 




. BYTE 

$7F 

5675 

FEDC 

10 

F8 



. WORD 

TAB 

5676 

FEDE 

9B 




. BYTE 

$9B 

5677 

FEDF 

30 

FA 



. WORD 

DOCRWS 

5678 

FEE1 

9C 




. BYTE 

$9C 

5679 

FEE2 

D4 

F8 



. WORD 

DELL IN 

5680 

FEE4 

9D 




. BYTE 

$9D 

5681 

FEES 

A4 

F8 



. WORD 

INSLIN 

5682 

FEE7 

9E 




. BYTE 

$9E 

5683 

FEE8 

32 

F8 



. WORD 

CLRTAB 

5684 

FEEA 

9F 




. BYTE 

$9F 

5685 

FEEB 

2D 

F8 



. WORD 

SETTAB 

5686 

FEED 

FD 




. BYTE 

$FD 

5687 

FEEE 

OA 

F9 



. WORD 

BELL 

5688 

FEFO 

FE 




. BYTE 

$FE 

5689 

FEF1 

6D 

F8 



. WORD 

DELCHR 

5690 

FEF3 

FF 




. BYTE 

$FF 

5691 

FEF4 

37 

F8 



. WORD 

I NSC HR 

5692 








5693 








5694 








5695 








5696 








5697 






ATAINT: ATASCI 

TO INTERNAL TABLE 

5698 








5699 

FEF6 

40 

00 

20 

60 

a*TAINT: . BYTE 

$40, $00, $20, $60 

5700 








5701 








5702 






INTATA: INTERNAL TO ATASCI TABLE 

5703 








5704 

FEFA 

20 

40 

00 

60 

INTATA: . BYTE 

$20, $40, $00, $60 

5705 








5706 








5707 






ATASCI; ATASCI I CONVERSION TABLE 

5708 








5709 

FEFE 

6C 

6A 

3B 

80 

ATASCI: .BYTE 

$6C, $6A, $3B, $80, $80, $6B, $2B, $2A ; LOWER CASE 

5710 

FF02 

80 

6B 

2B 

2A 



5711 

FF06 

6F 

80 

70 

75 

. BYTE 

$6F , $80, $70, $75, $9B, $69, $2D, $3D 

5712 

FFOA 

9B 

69 

2D 

3D 



5713 

FFOE 







5714 

FFOE 

76 

80 

63 

80 

. BYTE 

$76, $80, $63, $80, $80, $62, $78, $7A 

5715 

FF12 

80 

62 

78 

7A 
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5716 

FF16 

34 

80 

33 

36 

. BYTE 

5717 

FF1A 

IB 

35 

32 

31 


5718 

FF1E 






5719 

FF1E 

2C 

20 

2E 

6E 

. BYTE 

5720 

FF22 

80 

6D 

2F 

81 


5721 

FF26 

72 

80 

65 

79 

. BYTE 

5722 

FF2A 

7F 

74 

77 

71 


5723 

FF2E 






5724 

FF2E 

39 

80 

30 

37 

. BYTE 

5725 

FF32 

7E 

38 

3C 

3E 


5726 

FF36 

66 

68 

64 

80 

. BYTE 

5727 

FF3A 

82 

67 

73 

61 


5728 

FF3E 






5729 

FF3E 






5730 

FF3E 

4C 

4A 

3A 

80 

. BYTE 

5731 

FF42 

80 

4B 

5C 

5E 


5732 

FF46 

4F 

80 

50 

55 

. BYTE 

5733 

FF4A 

9B 

49 

5F 

7C 


5734 

FF4E 






5735 

FF4E 

56 

80 

43 

80 

. BYTE 

5736 

FF52 

80 

42 

58 

5A 


5737 

FF56 

24 

80 

23 

26 

. BYTE 

5738 

FF5A 

IB 

25 

22 

21 


5739 

FF5E 






5740 

FF5E 

5B 

20 

5D 

4E 

. BYTE 

5741 

FF62 

80 

4D 

3F 

81 


5742 

FF66 

52 

80 

45 

59 

. BYTE 

5743 

FF6A 

9F 

54 

57 

51 


5744 

FF6E 






5745 

FF6E 

28 

80 

29 

27 

. BYTE 

5746 

FF72 

9C 

40 

7D 

9D 


5747 

FF76 

46 

48 

44 

80 

. BYTE 

5748 

FF7A 

83 

47 

53 

41 


5749 

FF7E 






5750 

FF7E 






5751 

FF7E 

OC 

OA 

7B 

80 

. BYTE 

5752 

FF82 

80 

OB 

IE 

IF 


5753 

FF86 

OF 

80 

10 

15 

. BYTE 

5754 

FF8A 

9B 

09 

1C 

ID 


5755 

FF8E 






5756 

FF8E 

16 

80 

03 

80 

. BYTE 

5757 

FF92 

80 

02 

18 

1A 


5758 

FF96 

80 80 

85 

80 

. BYTE 

5759 

FF9A 

IB 

80 

FD 

80 


5760 

FF9E 






5761 

FF9E 

00 

20 

60 

OE 

. BYTE 

5762 

FFA2 

80 

OD 

80 

81 


5763 

FFA6 

12 

80 

05 

19 

. BYTE 

5764 

FFAA 

9E 

14 

17 

11 


5765 

FFAE 






5766 

FFAE 

80 

80 

80 

80 

. BYTE 

5767 

FFB2 

FE 

80 

7D 

FF 


5768 

FFB6 

06 

08 

04 

80 

. BYTE 

5769 

FFBA 

84 

07 

13 

01 



$34, $80, $33, $36, $1B, $35, $32, $31 

$2C, $20, $2E, $6E, $80, $6D, $2F, $81 
$72, $80, $65, $79, $7F, $74, $77, $71 

$39, $80, $30, $37, $7E, $38, $3C, $3E 
$66, $68, $64, $80, $82, $67, $73, $61 

$4C, $4A, $3A, $80, $80, $4B, $5C, $5E ; UPPER CASE 
$4F, $80, $50, $55, $9B, $49, $5F, $7C 

$56, $80, $43, $80, $80, $42, $58, $5A 
$24, $80, $23, $26, $1B, $25, $22, $21 

$5B, $20, $5D, $4E, $80, $4D, $3F, $81 
$52, $80, $45, $59, $9F, $54, $57, $51 

$28, $80, $29, $27, $9C, $40, $7D, $9D 
$46, $48, $44, $80, $83, $47, $53, $41 

$0C, $0A, $7B, $80, $80, $0B, $1E, $1F ; CONTROL 
$0F, $80, $10, $15, $9B, $09, $1C, $1D 

$16, $80, $03, $80, $80, $02, $18, $1A 
$80, $80, $85, $80, $1B, $80, $FD, $80 

$00, $20, $60, $0E, $80, $0D, $80, $81 
$12, $80, $05, $19, $9E< $14, $17, $11 

$80, $80, $80, $80, $FE, $80, $7D, $FF 
$06, $08, $04, $80, $84, $07, $13, $01 
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5770 

5771 

5772 

5773 

5774 

5775 

FFBE 

AD 

09 

D2 

PIRG5: 

LDA 

KBCODE 


5776 

FFC 1 

CD 

F2 

02 


CMP 

CHI 

TEST AGAINST LAST KEY PRESSED 

5777 

FFC4 

DO 

05 



BNE 

PIRG3 

IF NOT, GO PROCESS KEY 

5778 

FFC6 

AD 

FI 

02 


LDA 

KEYDEL 

IF KEY DELAY BYTE > 0 

5777 

FFC9 

DO 

20 



BNE 

PIRG4 

IGNORE KEY AS BOUNCE 

5780 

FFCB 

AD 

09 

D2 

PIRG3: 

LDA 

KBCODE 

RESTORE AC 

5781 

FFCE 

C9 

9F 



CMP 

#CNTL1 

TEST CONTROL 1 (SSFLAG) 

5782 

FFDO 

DO 

OA 



BNE 

PIRG1 


5783 

FFD2 

AD 

FF 

02 


LDA 

SSFLAG 


5784 

FFD5 

49 

FF 



EOR 

#$FF 


5785 

FFD7 

8D 

FF 

02 


STA 

SSFLAG 


5786 

FFDA 

BO 

OF 



BCS 

PIRG4 

(UNCONDITIONAL) MAKE 'M INVISIBLE 

5787 

FFDC 

8D 

FC 

02 

PIRQ1: 

STA 

CH 


5788 

FFDF 

8D 

F2 

02 


STA 

CHI 


5789 

FFE2 

A9 

03 



LDA 

#3 


5790 

FFE4 

8D 

FI 

02 


STA 

KEYDEL 

INITIALIZE KEY DELAY FOR DEBOUNCE 

5791 

FFE7 

A9 

00 



LDA 

#0 

CLEAR COLOR SHIFT BYTE 

5792 

FFE9 

85 

4D 



STA 

ATRACT 


5793 

FFEB 

A9 

30 


PIRG4: 

LDA 

#$30 


5794 

FFED 

8D 

2B 

02 


STA 

SR T I MR 


5795 

FFFO 

68 



PIRQ2: 

PLA 



5796 

5797 

5798 

FFF 1 

40 



i 

i 

RTI 



5799 

FFF2 

FF 

FF 

FF FF 


. BYTE 

$FF, $FF, $FF, $FF, $FF, $FF 

5800 

FFF6 

FF 

FF 






5801 

5802 

FFF8 




i 

CRNTPC 

=* 



5803 






*=$14 



5804 

0014 

00 



KBDSPR: 

. BYTE 

$FFF8-CRNTPC 

; ■'•GDISPLC IS TOO LONG 

5805 

0015 





. END 
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CROSS REFERENCE 


LABEL 

VALUE 

REFERENCE 







ACK 

0041 

-1632 

1902 







ACKREC 

E9C6 

1785 

-1794 







ADDCOR 

030E 

-498 

2515 

2519 

2523 





ADJ1 

EDOC 

2533 

-2537 







ADJUST 

ED04 

2470 

2473 

-2532 






ADRESS 

0064 

-269 

4120 

4145 

4171 

4173 

4182 

4183 

4184 



4186 

4252 

4254 

4258 

4260 

4263 

4265 

4296 



4355 

4357 

4426 

4443 

4445 

4570 

4573 

4574 



4653 

4655 

4681 

4686 

4748 

4755 

4758 

4760 



4762 

4766 

4834 

4835 

4838 

4839 

5092 

5094 



5101 

5104 

5106 

5149 

5161 

5163 

5165 

5168 



5171 

5175 

5176 

5178 

5179 

5287 

5378 

5380 

ADRTAB 

E6FE 

-1292 

1327 







AFP 

D800 

-574 








ALLPOT 

D208 

-659 








ALLSEC 

F30E 

3886 

-3891 







ALOCAT 

FE45 

4146 

-5562 







ANCGNV 

FE69 

4139 

-5593 







ANTIC 

D400 

-735 

736 

737 

738 

739 

740 

741 

742 



743 

744 

745 

746 

747 

748 

749 

750 

APPEND 

0001 

-111 








APPMHI 

OOOE 

-179 

4761 

4765 






ASCC01 

F705 

4478 

-4480 







ASCZER 

0030 

-764 

1193 







ATACHR 

02FB 

-469 

4308 

4311 

4316 

4333 

4372 

4394 

4417 



4421 

4428 

4481 

4515 

4526 

4528 

4606 

5082 



5300 

5527 

5538 

5542 





ATAINT 

FEF6 

4343 

-5699 







ATAN 

BE43 

-602 








ATASCI 

FEFE 

4480 

-5709 







ATEOF 

FOOB 

3250 

-3256 







ATRAC T 

004D 

-248 

1340 

1395 

1401 

1403 

5792 



AUDC1 

D201 

-667 

2343 

2353 

2378 





AUDC2 

D203 

-669 

2354 







AUDC3 

D205 

-671 

2349 







AUDC4 

D207 

-673 








AUDCTL 

D208 

-674 

2336 







AUDF1 

D200 

-666 

2297 







AUDF2 

D202 

-668 

2295 







AUDF3 

D204 

-670 

1749 

2203 

2607 

3200 




AUDF4 

D206 

-672 

1751 

2205 

2609 

3202 




B192HI 

0000 

-1641 

1750 







B192L0 

0028 

-1640 

1748 







B600HI 

0005 

-1643 

2204 







B600L0 

OOCC 

-1642 

2202 







BAD 

EA63 

1919 

-1925 







BADCOM 

E9BF 

1782 

-1788 

1809 






BADDSK 

F306 

-3887 

3923 

3929 






BAD IOC 

0086 

-142 

826 









BADMOD 

0091 

-154 

4141 







BADST 

EE9E 

2914 

2917 

2963 

-2965 





BEEP 

F058 

3164 

3197 

-3314 






BEEP 1 

F05A 

-3315 

3349 







BEGIN 

ED10 

2255 

-2558 

2570 






BELL 

F90A 

4402 

-4726 

5687 






BELLI 

F90C 

-4727 

4729 







BFENHI 

0035 

-224 

1774 

1886 

1985 

2147 

2184 



BFENLO 

0034 

-223 

1771 

1883 

1983 

2145 

2179 



BITCLR 

FB 12 

4624 

5038 

-5046 






BITCON 

FAEB 

-5019 

5040 

5046 

5056 





BITGE1 

FB31 

5060 

-5062 







BITGET 

FB25 

4618 

4890 

-5056 






BITMSK 

006E 

-276 

5023 

5042 

5047 

5059 




BITPUT 

FB04 

4711 

-5038 

5129 

5138 





BITROL 

FAFA 

-5032 

5159 







BITSET 

FB06 

4622 

-5040 







BLACKB 

F22A 

-3740 

3741 







BLFILL 

EEC 1 

2992 

-2995 

3015 






BLIM 

028A 

-398 

3183 

3235 

3254 





8LKB2 

F230 

3740 

-3742 







BLKBDV 

E47 1 

-77 

3483 

3601 

3603 





BLOAD 

F36C 

3928 

-3933 







BOOT 

F2CF 

3710 

-3862 







BOOTAD 

0242 

-360 

3896 

3898 

3934 

3937 




BOOT? 

0009 

-176 

3864 

3931 

3991 

4007 




BOTSCR 

02BF 

-429 

4193 

4201 

4542 

4548 

4664 

4953 

5335 

BPTR 

003D 

-234 

3182 

3225 

3234 

3238 

3246 

3263 

3265 



3274 

3293 







BRKABT 

0080 

-136 

2637 

3188 

4466 

4983 




BRKKEY 

0011 

-184 

1337 

1957 

2064 

2558 

2580 

2643 

3189 



3220 

3831 

4467 

4509 

4984 

4985 



BRKKY 

0236 

-345 

1292 

3833 

3835 





BRKKY2 

E754 

-1336 

3832 

3834 






BROKE 

EDAO 

1959 

2066 

2560 

2581 

-2632 




BS 

F7E6 

-4591 

5673 







BS1 

F80D 

4593 

-4608 







BS2 

F805 

4601 

4603 

-4605 






BS3 

F7F5 

4596 

-4598 







BSA 

F7EC 

-4594 








BUFADR 

0015 

-187 

2829 

2838 

2842 

2863 

2865 



BUFCNT 

006B 

-274 

4386 

4410 

4412 

5219 

5229 

5232 

5240 



5249 








BUFFH 

0004 

-3421 

3422 

3883 






BUFFL 

0000 

-3422 

3881 







BUFFUL 

EECB 

2989 

-3000 







BUFRFL 

0038 

-227 

2054 

2111 

2160 





BUFRHI 

0033 

-222 

1773 

1885 

1980 

1984 

2142 

2146 

2182 



2624 

2626 







BUFRLO 

0032 

-221 

1769 

1881 

1951 

1978 

1982 

2009 

2133 



2140 

2144 

2177 

2615 

2617 

2621 

2623 


BUFSTR 

006C 

-275 

4389 

4391 

4406 

4408 

4584 

4588 

4927 



5214 

5216 

5263 

5265 







CAINI 

F239 

3669 

-3750 







CART 

BFFC 

-3436 

3658 

3666 

3781 

3783 

3784 

3793 


CARTAD 

BFFE 

-3438 

3750 

3751 

3788 





CARTCS 

BFFA 

-3435 

3720 

3726 






CARTFG 

BFFD 

-3437 

3702 

3705 

3717 

3723 

3786 



CAS31 

EC5E 

2352 

-2357 







CASBUF 

03FD 

-545 

3101 

3102 

3237 

3248 

3253 

3264 

3295 



3301 

3389 

3391 

3392 

3421 

3422 

3892 

3900 



3902 

3905 







CASENT 

EB80 

1734 

-2197 







CASET 

0060 

-1611 

1732 

2289 

2351 





CASETV 

E440 

-59 

3118 

3513 

3849 





CASFLG 

030F 

-499 

1739 

2050 

2234 





CAS IN I 

0002 

-169 

4009 

4011 

4014 





CASORG 

EF41 

-30 

3097 

3136 






CASRED 

EBB3 

2198 

-2233 







CASSBT. 

004B 

-245 

3888 

3922 

3925 

3975 

4001 

4005 


C ASSET 

0043 

-124 








CASSPR 

0014 

-3398 








CAUX1 

023C 

-351 

1763 







CAUX2 

023D 

-352 

1765 







CBAUDH 

02EF 

-457 

2602 

2608 

3144 





CBAUDL 

02EE 

-456 

2601 

2606 

3142 





CB INI 

F23C 

3661 

-3751 







CBUFH 

0003 

-3101 

3102 

3366 






CBUFHI 

0002 

-1669 

1670 

1772 






CBUFL 

OOFD 

-3102 

3368 







CBUFLO 

003A 

-1670 

1768 







CCOMND 

023B 

-350 

1760 







CDEVIC 

023A 

-349 

1669 

1670 

1757 





CDTMA1 

0226 

-330 

1528 

2653 

2655 





CDTMA2 

022S 

-331 

1529 







CDTMF3 

022A 

-332 

1455 

3177 

3179 

3219 

3222 



CDTMF4 

022C 

-334 








CDTMF5 

022E 

-336 








CDTMV1 

0218 

-323 

1451 

1452 

1535 

1537 

1539 

1540 

1542 



1564 

1566 







CDTMV2 

021 A 

-324 








CDTMV3 

02 1C 

-325 








CDTMV4 

021E 

-326 








CDTMV5 

0220 

-327 








CDUBL 

EF26 

3072 

-3075 







CH 

02FC 

-470 

1478 

4087 

4462 

4469 

4474 

5787 


CHI 

02F2 

-461 

5776 

5788 






CHACT 

02F3 

-463 

1442 

4110 






CHACTL 

D401 

-737 

1443 







CHAR 

02FA 

-468 

4302 

4344 

4346 

5069 

5079 



CHBAS 

02F4 

-464 

1440 

4108 






CHBASE 

D409 

-743 

1441 







CHKDON 

EABA 

1995 

-2002 

2017 






CHKERR 

008F 

-151 

2118 







CHKSNT 

003B 

-230 

1947 

1988 

1994 

2026 




CHKSUM 

0031 

-220 

1946 

1955 

1991 

2013 

2015 

2053 

2115 





2136 

2138 

CHKTIM 

EAF9 

-2064 

2071 

CHR0R0 

EOOO 

-22 


CICL02 

E53F 

901 

-903 

CICLOS 

E533 

853 

-898 

CIERR1 

E4D1 

821 

-826 

CIERR2 

E6B0 

1173 

-1183 

CIERR3 

E50F 

-869 


CIERR4 

E51 1 

842 

-870 

Cl JUMP 

E693 

1152 

-1158 

C INI 

F3E1 

3994 

-4014 

CIO 

E4C4 

771 

-815 

CIOCHR 

002F 

-217 

815 



1026 

1037 

cioii 

E4A8 

-787 

798 

CIOINT 

E4A6 

775 

-786 

CIOINV 

E46E 

-76 

774 

CIOORG 

E4A6 

-25 

783 

Cl OPEN 

E509 

851 

-864 

CIOSPR 

0014 

-1215 


CIOV 

E456 

-68 

770 

CIREAD 

E569 

857 

-934 

CIRT3 

E62B 

-1075 

1080 

CIRTN1 

E61B 

827 

870 

CIRTN2 

E61D 

893 

909 

CIST1 

E559 

916 

-923 

CISTSP 

E54E 

855 

-914 

CIWRIT 

E5C9 

858 

-1003 

CIX 

00F2 

-616 


CKEY 

004A 

-244 

3856 

CKSTC 

EE1 1 

2808 

-2810 

CLICK 

FCD8 

4475 

4727 

CLICK1 

FCDA 

-5356 

5359 

CLOSE 

OOOC 

-93 


CLOSEC 

F02B 

3119 

-3286 

CLRCHP 

F27A 

-3820 

3825 

CLRCOD 

007D 

-4030 

4312 

CLRLI1 

FBA6 

-5149 

5151 

CLRLIN 

FB9B 

4697 

-5144 

CLRRAM 

F 1 40 

-3591 

3594 

CLP. SC 2 

F7BF 

-4570 

4572 

CLRSC3 

F7CE 

-4578 

4581 

CLRSCR 

F7B9 

4280 

4314 

CLRTAB 

F832 

-4623 

5683 

CLRTBS 

F430 

-4125 

4127 

CLS 

007D 

-3416 

3527 

CLWRT 

F038 

3287 

-3293 

CMODE 

EF1E 

-3071 

3087 

CMPTAB 

E6F6 

-1282 

1313 

CNTL1 

009F 

-4031 

5781 

CNTRLS 

FEC6 

4442 

4444 

COLAC 

0072 

-279 
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PUTDAT 

0080 

-2752 

2809 






PUTDTO 

EE01 

2801 

-2803 






PUTLIN 

F385 

3735 

-3958 






PUTMSC 

FCF3 

4567 

4782 

-5377 





PUTREC 

0009 

-91 







PUTSEC 

0050 

-2745 







PUTTXT 

0009 

-3406 

3963 






PWRONA 

F3E4 

4049 

4062 

4076 

-4086 




PWRUP 

F125 

3493 

3497 

3566 

-3576 

3686 



PWRUP1 

FI 28 

3568 

-3578 






RADFLG 

OOFB 

-622 







RADON 

0000 

-623 







RAMLO 

0004 

-170 

3589 

3590 

3591 

3595 

3596 

3795 



3800 

3801 

3804 

3897 

3899 

3906 

3910 



3913 

3915 

3936 

3939 

3940 



RAMSIZ 

02E4 

-451 

3655 

3663 

3837 




RAMTOP 

006A 

-273 

4090 

4133 

4144 

4207 

4229 

4575 



5180 







RANDOM 

D20A 

-661 







RANGE 

FA96 

4290 

4309 

4955 

4957 

-4959 

5522 

5534 

RANGE 1 

FAB7 

4969 

-4975 






RANGE2 

FABB 

4974 

-4977 






RANGE3 

FA9E 

4961 

-4963 






RBLOK 

EFE9 

3130 

3236 

-3241 





RBLOKV 

E47A 

-80 

3129 

3977 





RCI1 

E5A7 

963 

968 

-973 





RCI11 

E5BF 

-994 







RC 1 1 A 

E574 

936 

-943 






RCI1B 

E571 

-940 

944 







3798 

3912 

5166 



RC 12 

E5AC 

-979 








RC 13 

E587 

949 

-955 

974 






RC 14 

E5C3 

957 

970 

981 

986 

-998 




RC 16 

E5B2 

-984 

991 







RDBAD 

EE51 

-2838 

2845 







RDBYTE 

F310 

-3892 

3895 







RDONLY 

0087 

-143 

1008 







READ 

0052 

-1616 

3978 







RECEIV 

EAEO 

1840 

1891 

-2048 

2257 





RECVDN 

0039 

-228 

2055 

2070 

2122 





RECVDS 

EC60 

-2371 








RECVEN 

EC IB 

2061 

-2320 







REDGE 

0027 

-253 

3624 







RELONE 

EAB1 

1989 

-1997 







RENAME 

0020 

-100 








RESET 

FI IB 

3489 

3499 

-3564 






RETUR1 

F634 

4044 

4047 

4057 

4060 

4070 

4071 

4074 

4294 



4364 

4366 

-4369 

4529 

4996 

5334 

5553 


RETUR2 

F621 

4287 

4315 

4320 

4323 

-4361 

4422 

4447 


RETUR3 

FAE1 

4994 

-4996 







RETURN 

EAOD 

1831 

1851 

1854 

-1861 

2265 

2646 



RIRGHI 

0000 

-1660 

2241 







RIRGLO 

0078 

-1655 

2240 







RMARGN 

0053 

-257 

3625 

4557 

4562 

4600 

4869 

4960 

4962 



5227 

5246 

5283 






RNGER 1 

FAD8 

-4991 








RNGER2 

FAD6 

4986 

-4990 







RNGER R 

FAD1 

4966 

4967 

4973 

4976 

4979 

4980 

-4988 


RNGQK 

FAC4 

4971 

-4981 







ROWAC 

0070 

-278 

4940 

4942 

4943 

4945 

5442 

5470 

5476 



5478 

5480 

5481 

5485 





ROWCRS 

0054 

-258 

4329 

4388 

4407 

4540 

4544 

4546 

4547 



4586 

4602 

4646 

4663 

4690 

4701 

4702 

4776 



4783 

4849 

4887 

4904 

4913 

4933 

4965 

5053 



5132 

5134 

5189 

5215 

5224 

5236 

5248 

5277 



5313 

5324 

5339 

5342 

5398 

5444 

5489 

5491 



5529 

5533 







ROWINC 

0079 

-283 

5405 

5413 

5490 





RRETRN 

EBOE 

-2081 








RSIRG 

OOOA 

-1657 

2236 







RTCLOK 

0012 

-185 

1393 

1396 

1398 

1404 

2573 

2599 

3315 



3334 

3347 







S 

0053 

-2902 

3079 







SAVADR 

0068 

-272 

4033 

4185 

4187 

4262 

4264 

4654 

4656 



4668 

4672 







SAVIO 

0316 

-505 

2571 

2590 

2592 





SAVMSC 

0058 

-261 

4172 

4174 

4241 

4243 

5160 

5162 

5377 



5379 








SBUFSZ 

00 ID 

-2895 

3081 







SCOLLP 

E80E 

-1433 

1439 







SCREDT 

0045 

-120 








SCRENV 

E410 

-56 

3517 

3846 

4052 





SCRFLG 

02BB 

-425 

4629 

4644 

4926 







SCRMEM 

0093 

-156 

4768 





SCRNOK 

F1DB 

3685 

-3687 

3688 

3690 



SCROL1 

FBB7 

4721 

-5164 

5177 

5181 



SCR0L2 

FBCA 

5169 

5172 

-5174 




SCROLL 

FBAC 

4925 

-5159 





SDLSTH 

0231 

-339 

1423 





SDLSTL 

0230 

-338 

1425 

4253 

4255 

4266 

4268 

SDMCTL 

022F 

-337 

1427 

4111 

4285 

4286 


SECT1 

F301 

-3885 

4003 





SECTX 

F34C 

-3919 

3924 





SEND 

EA6B 

-1940 

2225 

2443 




SENDDS 

EC5F 

1861 

1964 

-2370 

2632 



SENDEN 

EBF2 

1692 

1943 

2207 

-2284 



SENDEV 

E468 

-74 

1691 

3205 




SEND IN 

EC 8 A 

1779 

1807 

-2436 




SERIN 

D20D 

—663 

2114 

2131 




SEROUT 

D20D 

-677 

1952 

1992 

2010 



SETBSZ 

EF34 

3074 

3078 

-3082 




SETDCB 

EEE6 

2961 

3004 

-3034 




SETLOP 

E8F7 

-1561 

1562 





SETTAB 

F82D 

-4621 

5685 





SETVBL 

E8ED 

1224 

1226 

-1556 




SETVBV 

E45C 

-70 

1225 

2660 

3178 

3217 


SETVBX 

EDB9 

2215 

2242 

2253 

2447 

-2652 


SEX 

0000 

-3415 

3675 

3959 




SFH 

EF64 

-3163 






SHFAMT 

006F 

-277 

4298 

4347 

4843 



SHFLOK 

02BE 

-428 

4092 

4493 

4498 

4503 

4520 

SHIFT1 

F5B1 

4299 

-4302 





SHIFT2 

F610 

4348 

-4351 





SHIFTD 

F5AA 

-4298 

4301 





SHIFTU 

F608 

-4347 

4350 





SIDWAY 

0053 

-1624 






SIGNON 

F223 

3485 

-3733 





SIN 

BD81 

-600 






SIO 

E959 

1686 

-1726 





SIOINT 

E944 

1689 

-1706 





SIOINV 

E465 

-73 

1688 

3851 




SIOORG 

E944 

-27 

1584 

1702 




SIOSB 

F095 

3242 

-3361 

3394 




SIOSPR 

0014 

-2727 






siav 

E459 

-69 

1685 

2821 

2962 

3005 

3384 

SIRHI 

OOEB 

-2423 

2424 





SIRLO 

OOOF 

-2424 






SIZEM 

DOOC 

-694 






SIZEPO 

D008 

-690 






SIZEP1 

D009 

-691 






SIZEP2 

DOOA 

-692 






SIZEP3 

DOOB 

-693 






SKCTL 

D20F 

-679 

1716 

2300 

2324 



SKRES 

D20A 

-676 

2097 

2326 




SKSTAT 

D20F 

-665 

1459 

1469 

2096 

2568 

2588 2611 2613 

SOUNDR 

0041 

-238 

1715 

2340 






SPACE 

0020 

-2899 

2995 







SPEC I A 

EF4B 

3119 

-3145 







SPEC I L 

OOOE 

-95 

846 

848 






SPECL 

F23F 

3582 

-3781 







SGR 

BEB1 

-603 








SRETRN 

EB34 

2116 

-2121 

2156 






SRSTA 

0040 

-3103 

3377 







SRTIM2 

0006 

-1219 

1475 







SRTIMR 

022B 

-333 

1467 

1472 

1476 

1526 

5794 



SRTIRO 

EB9B 

2211 

-2214 







SRTIR1 

EBC 1 

2238 

-2241 







SRTIR2 

EBE9 

2260 

-2265 







SSFLAG 

02FF 

-473 

1338 

4326 

5783 

5785 




SSKCTL 

0232 

-340 

1714 

2285 

2299 

2321 

2323 

2612 


STACK 

S 0000 

0 








STACKP 

0318 

-507 

1727 

2640 






STATC 

0053 

-2748 

2810 

2825 

2958 

3042 

3871 



STATIS 

OOOD 

-94 








STATU 

F028 

3119 

-3280 







STATUS 

0030 

-219 

1846 

1849 

1864 

1894 

1911 

1915 

1917 



1927 

1941 

2060 

2074 

2103 

2109 

2119 

2638 

STATVH 

0002 

-2736 

2737 

2814 






STATVL 

OOEA 

-2737 

2812 







STICKO 

0278 

-379 

1487 

1491 

1509 





STICK1 

0279 

-380 








STICK2 

027A 

-381 








STICK3 

027B 

-382 








STIMER 

D209 

-675 








STLOOP 

ES77 

-1482 

1494 







STORE 

F917 

4190 

4204 

4210 

4212 

4214 

4222 

4232 

4234 



4236 

4238 

4242 

4244 

4247 

4249 

4251 

4257 



4267 

4269 

-4745 






STORE 1 

F91D 

-4748 








STRBEG 

FC5C 

4545 

-5261 







STRERR 

F942 

4764 

-4768 







STRIGO 

0284 

-391 

1498 







STRIG1 

0285 

-392 








STRIG2 

0286 

-393 








STRIGO 

0287 

-394 








STRL 

E890 

-1497 

1504 







STROK 

F946 

4746 

4754 

4763 

4767 

-4770 




STTMQT 

EC75 

1815 

2252 

-2396 






SUBBFL 

E677 

998 

1059 

-1138 






SUBEND 

FA7A 

-4939 

5493 

5521 






SUBTMP 

029E 

-414 

4752 

4757 






SUCCES 

0001 

-134 

898 

1850 

1895 

1940 

2059 

2993 

3016 



3226 

3239 

3266 

3280 

3289 

4112 

4370 

4981 

SUSUAL 

EB38 

-2124 

2148 

2162 






SV7H 

00E8 

-1523 

1524 







SV7L 

0073 

-1524 








SWAP 

FCB3 

4384 

4398 

4418 

4424 

4429 

4436 

4448 

-5333 

SWAP 1 

FCC2 

-5339 

5346 







SWAP3 

FCD7 

5337 

-5350 









SWAPA 

FCB9 

4995 

5333 

-5335 





SWPFLG 

0Q7B 

-285 

4121 

4907 

4993 

5221 

5347 

5349 

SWSTA 

0080 

-3104 

3380 






SYIRG 

E706 

1243 

-1301 






SYIRQ2 

E71B 

1304 

-1310 






SYIRG8 

E762 

1322 

-1343 






SYIRG9 

E76F 

1346 

-1349 






SYIRGA 

E77A 

1350 

-1353 






SYIRGB 

E78F 

1235 

1236 

1237 

1240 

1241 

1242 

-1364 

SYRTI 

E790 

1234 

-1365 






SYRTI2 

E78B 

1358 

-1362 






SYSVB1 

E7BA 

1394 

1397 

-1399 





SYSVB2 

E7D6 

1410 

-1412 






SYSVB3 

E7E5 

1417 

-1419 






SYSVB4 

E832 

1446 

-1448 






SYSVB6 

E8C3 

1471 

-1525 






SYSVB7 

E873 

1468 

1473 

-1480 

1523 

1524 

1527 


SYSVBA 

E844 

1453 

-1456 






SYSVBB 

E834 

-1449 

1457 






SYSVBL 

E7AE 

1227 

1247 

-1393 





SYSVBV 

E45F 

-71 







SYVB6A 

E857 

1461 

1464 

-1467 





TAB 

F810 

-4609 

4619 

5675 





TAB1 

F823 

4612 

4615 

-4617 





TAB2 

F82A 

4616 

-4620 






TABMAP 

02A3 

-419 

4125 

5041 

5043 

5049 

5050 

5058 

TBLENT 

F0E3 

-3510 

3538 

3641 





TBLLEN 

OOOE 

-3538 

3640 






TDHI 

OOEA 

-2427 

2428 






TDLO 

OOCF 

-2428 







TEMP 

023E 

-354 

1667 

1668 

1901 




TEMPI 

0312 

-502 

2478 

2496 





TEMP2 

0314 

-503 







TEMP 3 

0315 

-504 

2578 

2596 





TEMPHI 

0002 

-1667 

1668 

1884 





TEMPLO 

003E 

-1668 

1880 






TIMER 1 

030C 

-497 

2472 

2474 

2477 

2481 

2574 

2575 

TIMER2 

0310 

-500 

2468 

2469 

2471 

2475 

2479 


TIMFLG 

0317 

-506 

2068 

2220 

2247 

2274 

2564 

2583 

TIMIT 

EBA5 

-2220 

2221 






TIMIT1 

EBCB 

-2247 

2248 






TIMOUT 

008A 

-146 

1918 

2073 





TINDEX 

0293 

-409 

4119 






TMPCHR 

0050 

-254 

4352 

4356 

5097 

5100 



TMPCOL 

02B9 

-424 







TMPLBT 

02A1 

-417 

4818 

4827 

4831 




TMPROW 

02B8 

-423 

5314 

5323 





TMPX1 

029C 

-412 







TOADR 

0066 

-4034 

4685 

4689 

5096 

5099 

5109 

5111 

TONE1 

0002 

-3113 

3196 






T0NE2 

0001 

-3114 

3163 






TOUT 

EBOA 

2069 

-2073 

2586 





TOUT1 

ED44 

2566 

-2585 







5366 


2662 


5113 



TRAMSZ 


0006 


-171 3597 

3805 3808 


TRIGO 

D010 

-730 

1497 

TRIG1 

DOU 

-731 


TRIG2 

DO 12 

-732 


TRIG3 

DO 13 

-733 


TRNRCD 

0089 

-145 

994 

TSTAT 

0319 

-508 

1845 

TSTCT1 

FC8F 

-5299 

5305 

TSTCT2 

FC9C 

5301 

-5306 

TSTCTL 

FC8D 

4432 

4524 

TSTDAT 

0007 

-172 

3653 

TWICE 

EE4F 

-2836 

2840 

TXTCOL 

0291 

-408 

4283 

TXTMSC 

0294 

-410 

4135 

TXTOLD 

0296 

-411 


TXTROW 

0290 

-407 

4281 

UNLOCK 

0024 

-104 


UPDNCM 

F787 

-4544 

4551 

USAREA 

0480 

-548 


VBATRA 

E7C8 

1402 

-1406 

VBREAK 

0206 

-314 

1361 

VBWAIT 

F496 

-4175 

4177 

VCOUNT 

D40B 

-745 

2572 

VC TAB L 

E480 

-24 

1232 

VDELAY 

D01C 

-710 


VDSLST 

0200 

-311 

1232 

VECTBL 

E400 

-23 


VIMIRG 

0216 

-322 

1281 

VINTER 

0204 

-313 

1352 

VKEYBD 

0208 

-315 

1293 

VPRCED 

0202 

-312 

1348 

VSCROL 

D405 

-741 


VSERIN 

020A 

-316 

1299 

VSEROC 

020E 

-318 

1297 

VSEROR 

020C 

-317 

1298 

VTIMR1 

0210 

-319 

1296 

VTIMR2 

0212 

-320 

1295 

VTIMR4 

0214 

-321 

1294 

VVBLKD 

0224 

-329 

1522 

VVBLKI 

0222 

-328 

1385 

WAIT 

EA1 A 

-1876 

2449 

WAITER 

EC9B 

1820 

-2447 

WAITTM 

EF7C 

-3179 

3180 

WARMST 

0008 

-175 

3578 

WARMSV 

E474 

-78 

1379 

WATCOM 

E9D7 

1795 

-1815 

WCI1 

E605 

1034 

1039 

WC 1 1 A 

E5D4 

1005 

-1012 

WC I IB 

ESDI 

-1009 

1013 

WC 12 

E60A 

-1050 


WC 13 

E5E5 

1018 

-1024 

WC 14 

E5EB 

1021 

-1027 


3654 3668 3697 3700 3715 3797 
3836 

1928 

-5298 

3660 3698 3703 3721 

4137 

5341 5344 


2598 4175 

1694 3630 4081 

1374 

4081 

1309 1694 


3584 3588 3862 3989 

3487 

-1044 


1045 



WCI5 

E615 

1028 

1041 

1052 

-1059 

WDLR 

EFC6 

-3220 

3223 



WFAK 

F087 

3337 

-3350 



WFAK1 

F08C 

3350 

-3353 



WFL 

F060 

-3324 

3335 



WIRGHI 

OOOO 

-1659 

2214 



WIRGLO 

00B4 

-1654 

2213 



WMODE 

0289 

-397 

3161 

3191 

3195 

WOK 

EA3D 

-1901 




WRITE 

0057 

-1617 

2807 



WR I TEC 

0057 

-2898 

3069 



WRONLY 

0083 

-139 

939 



WSIOSB 

F0D2 

3272 

3297 

3305 

-3389 

WSIRG 

OOOF 

-1656 

2209 



WSYNC 

D40A 

-744 

1560 

5357 


WTLR 

F046 

3294 

-3299 



XBO0T 

F361 

3926 

-3928 



XITVBL 

E905 

1228 

1248 

1418 

-1571 

XITVBV 

E462 

-72 




XMTDON 

003A 

-229 

1948 

1961 

2029 

XXIT 

E7E2 

1413 

-1418 



ZERIT 

EC6D 

-2378 

2381 



ZERORM 

FI 38 

-3587 




ZIOCB 

0020 

-199 




Z0SRAM 

FI 60 

3585 

-3610 



Z0SRM2 

FI 63 

-3612 

3615 



Z0SRM3 

F16E 

-3617 

3619 



ZTBUF 

F04A 

-3301 

3303 



Z TEMPI 

OOFS 

-618 




ZTEMP3 

00F9 

-620 




Z TEMP 4 

00F7 

-619 
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I 


INTRODUCTION 


The ATARI (R) 800™ and ATARI 400™ Personal Computer Systems 
contain a 6502 microprocessor, 41/0 chips, operating system ROM, expandable 
RAM, and several MSI chips for address decoding and data bus buffering. 

This manual is primarily intended to describe the 4 I/O chips in sufficent 
detail to allow experienced programmers to create assembly language programs, 
such as video games. All four Input/Output chips are controlled by the 
microprocessor by writing directly into their registers which are decoded 
to exist in microprocessor memory space just as RAM does. These I/O chips 
can also be interrogated by the microprocessor by reading similar registers. 

Many registers are write only and cannot be read after they are 
written. In some cases, reading from the same address gives the value 
contained in a separate read only register. Some write only registers are 
strobes. No data bits are needed in this case since the presence of the 
address on the bus is what triggers the requested action. The usual 
convention is to use the STA (Store Accumulator) instruction for such 
registers. For example, STA WSYNC performs the wait for Sync function. 

STX (Store X) or STY (Store Y) would work just as well. In BASIC, a POKE 
could be used (the data could be anything). Reading a register is accomp- 
lished by using any of the load instructions (LDA, LDX etc.). In BASIC 
a PEEK would be used. When the hardware register names are defined in an 
equate list, the programmer can refer to the registers by name rather than 
using the addresses directly. 

It is really not necessary for the programmer to know which 
I/O functions are performed by which of the 4 chips, however it 
does help in learning these functions. 

This manual should be used in conjunction with the Operating 
System (OS) Manual, a 6502 programming manual, and the ATARI 400/800 
Basic Reference Manual. 


CHIP NAME FUNCTION 


ANTIC 


CTIA 


DMA(Direct Memory Access) control 
NMI (Non-Maskable Interrupt) control 
Vertical and Horizontal fine scrolling 
Light pen position registers 
Vertical line counter 
WSYNC (wait for horizontal sync) 

Priority control (display of overlapping objects) 
Color-Lumimance control (colors and brightness assigned 
to all objects including DMA objects from ANTIC) 
PLAYER-MISSILE objects (4 players and 4 missiles) 
Graphics registers 
Size control 

Horizontal position control 
Collision detection between all objects 
Switches and triggers (miscellaneous 1/0 functions) 
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CHIP NAME 


FUNCTION 


POKEY Keyboard scan and control 

Serial communications port (bidirectional) 

Pot scan (digitizes position of 8 independent pots) 
Audio generation (4 channels) 

Timers 

IRQ (maskable interrupt) control from peripherals 
Random number generator 


PIA Controller (Joystick) jacks read or write 

Peripheral control and interrupt lines 
IRQ (maskable) interrupt control from peripherals 


Section II describes the hardware in some detail, including the 
various graphics modes. Section III lists the hardware registers one at a 
time, describing what each bit is used for. It is organized by functional 
groups (interrupts, graphics, audio, etc.). Section IV contains a sample 
display program. Section V contains various figures and block diagrams of 
the system. Sections VI and VII list the hardware registers in address 
order and alphabetical order. Section VII includes hex and decimal 
addresses, the OS shadow registers and the page numbers where more infor- 
mation can be found. 
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II • DESCRIPTION OF HARDWARE 


A. ANTIC AND CTIA 

TV Display : The ANTIC and CTIA chips generate the television 
display at the rate of 60 frames per second on the NTSC (US) system. 

The PAL (European) system is different and is described in the section 
on NTSC vs PAL. Each frame consists of 262 horizontal TV lines and each 
line is made up of 228 color clocks, as shown in figure VI-3. The 6502 
microprocessor runs at 1.79 MHz. This rate was chosen so that one 
machine cycle is equivalent in length to two color clocks. One clock 
Is approximately equal in width to two TV lines. 

In any graphics mode, the display is divided up into small squares 
or rectangles called pixels (picture elements). The highest resolution 
graphics mode has a pixel size of 1/2 color clock by 1 TV line. A 
sample display list is given in section IV. 

The current TV line may be determined by reading the vertical counter 
(VCOUNT). This register gives the line count divided by 2. There are 262 
lines per frame so VCOUNT runs from 0 to 130 (0 to 155 on the PAL system). 
The 0 point occurs near the end of vertical blank (see figure VI. 5). 
Vertical blank (VBLANK) is the time during which the electron beam returns 
back to the top of the screen in preparation for the next frame. The 
Atari 800 does not do interlacing, so each frame is identical unless 
the program which is being executed changes the display. Vertical sync 
(VSYNC) occurs during the fourth through sixth lines of vertical blank 
(VCOUNT = hex 7D through 7F) . This tells the TV set where each frame 
starts. After VSYNC, there are 16 more lines of VBLANK for a total of 22 
lines of VBLANK. The display list jump and wait instruction (to be 
described later) causes the display list graphics to start at the end of 
VBLANK. 


Operating System (OS) : The ATARI 400/800 comes with a 10K Operating 
System (OS) in ROM. The OS affects some of the hardware registers, so 
it will be mentioned from time to time in this manual. Refer to the OS 
manual for more details. The OS descriptions in this manual apply to the 
version that was being distributed when this manual was written. 

The OS supports most of the hardware graphics modes (BASICS, GRAPHICS, 
PLOT, and DRAWTO commands). The OS always displays 24 background lines after 
the end of vertical blank. This convention is used at Atari to compensate 
for television sets which overscan. Most TV's are designed so that the 
edges of the picture are cut off. This is fine for ordinary broadcasts, 
but with a computer it is essential for all important information to be 
displayed on the screen. It is fairly common for four to eight color 
clocks at the right or left edge of the picture to overscan. A TV set 
that has excessive overscan may have to readjusted to obtain a satisfactory 
display. 
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The OS uses 192 TV lines for its display and devotes the remaining 
24 lines to overscan. It uses the standard display width of 160 color 
clocks. The hardware will allow displays of any length, but it is recom- 
mended that the standards be followed. The exception might be a border 
or other information which is merely decorative and not essential to use 
of the program. 


OS Shadowing : Since many of the hardware registers are write-only 
and cannot be read the OS has a number of "shadow registers" in RAM. 

Every TV frame during vertical blank the OS takes the values in some of 
its shadow registers, and writes them out to the corresponding hardware 
register. The OS does attract color shifting on all of the color registers 
if ATRACT (on OS register) is negative. This is to prevent damage to the 
TV screen phosphors which can occur if the brightness is turned up too high 
and the same high- luminance display is left on for a long time. The OS also 
reads the joysticks and other controllers during vertical blank and stores 
the results in shadow registers, so that user programs do not have to include 
code to unpack the data. There are a few interrupt-related registers which 
the OS changes or reads during interrupt processing. Programs usually access 
the OS shadow registers instead of accessing the hardware directly. However, 
the OS shadowing can be disabled by changing the vertical blank and interrupt 
vectors (see OS manual) . 


WSYNC : In addition to a Vertical Blank Interrupt, which allows the 

Microprocessor to synchronize to the vertical TV display, this system also 
provides a Wait for Horizontal Sync (WSYNC) command that allows the 
microprocessor to synchronize itself to the TV horizontal line rate. This 
sync takes effect when the processor writes to an I/O location called 
WSYNC, whenever it desires horizontal synchronization. Writing to this 
address sets a latch which pulls to zero a pin on the microprocessor 
called READY. When READY goes to zero the microprocessor stops and waits. 
The latch is automatically reset (returning READY true) at the beginning 
of the next horizontal blank interval, releasing the microprocessor to 
resume program execution. 


Object DMA (Direct Memory Access) : The primary function of the Antic 
chip is to fetch data from memory (independent of the microprocessor) for 
display on the TV screen. It does this with a technique called "Direct 
Memory Access" or DMA. It requests the use of the memory address and data 
bus by sending a signal called HALT to the microprocessor, causing the 
processor to become "TRI-STATE" (open circuit) all during the next computer 
cycle. The ANTIC chip then takes over the address bus and reads any data 
it wishes from memory. Another name for this type of DMA is "cycle stealing". 
Once initiated, this DMA is completely and automatically controlled by the 
Antic chip without need for futher microprocessor intervention. 

There are two types of DMA: Playfield and Player-Missile (see Figure 
II. 2). The playfield DMA control circuit on the Antic chip resembles a 
small dumb microprocessor. By halting the main microprocessor it can 
fetch its own instructions from memory (the display list) addressed by its 
program counter (display list pointer). Each instruction defines the type 
(alpha character or memory map) , and the resolution (size of bits on the 
screen) , and the location of the data in memory which is to be displayed 
on the next group of lines. 
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In order to begin this DMA the main microprocessor must store a 
display list of instructions in memory, store data to be displayed in 
memory, tell the ANTIC where the display list is (initialize the display 
list pointer) and enable the DMA control flags on the ANTIC (DMACTL 
register) • 

In addition to the playfield DMA described above, the ANTIC 
chip simultaneously controls another DMA channel. This type of DMA 
addresses PLAYER-MISSILE graphics data stored in memory and passes the 
graphics data on to the CTIA chip graphics registers. This type of DMA 
(if enabled) occurs automatically, interspersed with the playfield DMA 
described previously. This PLAYER-MISSILE DMA has no display list or 
instructions, and is therefore much simpler than the PLAYFIELD DMA. 

In addition to the two types of display DMA, the ANTIC chip also 
generates DMA addresses for the refresh of the dynamic memory RAM used 
in this system. This is also completely automatic and need be consider- 
ed by the programmer only if he is concerned with real-time programming 
where an exact count of the computer cycles is important. 


Color- luminance : A color-luminance register is used on the CTIA chip 
for each Player-Missile and Playfield type. Each color-lum register is 
loaded by the microprocessor with a code representing the desired color 
and luminance of its corresponding Player-Missile or Playfield type. As 
the serial data passes through the CTIA chip it is "impressed" with the 
color and luminance values contained in these registers , before being sent 
to the TV display. In areas of the screen where there are no objects the 
background color (COLBK) is displayed. The CTIA also does collision 
detection (to be described later). 


Priority : When moving objects, such as players and missiles, 
overlap on the TV screen (with each other or with Playfield) a decision 
must be made as to which object shows in front of the other. Objects 
which appear to pass in front of others are said to have Priority over 
them. Priority is assigned to all objects by the CTIA chip before the 
serial data from each object is combined with the other objects and sent 
to the TV screen. 

The priority of objects can be controlled by the microprocessor by 
writing into the control register PRIOR. The functions of the bits in 
this register are given in the table in the PRIOR register description in 
section III. 


Players and Missiles : The players and missiles are small objects 
which can be moved quickly in the horizontal direction by changing their 
position registers. They are called players and missiles because they 
were originally designed to be used in games for objects such as airplanes 
and bullets. However, there are many other possible applications for 
them. The four player-missile color registers, in conjunction with the 
four playfield color registers and the background color register, make 
it possible to display 9 different colors at the same time. 
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OBJECTS 

~n — 


(no objects = background) 




Figure II. 2 


OBJECT DISPLAY SOURCES 
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There are a total of four players and four missiles. The four 
missiles may be grouped together and used as a 5th player. These 
objects are positioned horizontally by 8 horizontal position registers 
(HPOS (X)). These registers may be reloaded at any time by the proces- 
sor, allowing an object to be replicated many times across a horizontal 
TV line. 

The shape of a player-missile is determined by the data in its 
graphics register (GRAF (X)). Players have independent 8 bit graphics 
registers. The four missiles have 2 bit registers (located within one 
address). These registers may also be reloaded at any time by the 
processor, although they are usually changed during horizontal blank 
time. The data in each graphics register is placed on the display 
whenever the horizontal sync counter equals the corresponding horizon- 
tal position register. The same data will be displayed every line unless 
the graphic registers are reloaded with new data. 

The player-missile graphic registers may be reloaded by the micro- 
processor (GRAF (X)), or automatically from memory with direct memory 
access (DMA) (see figure II. 3). The programmer must place the object 
graphics in memory, write the player-missile base address (PMBASE) , and 
enable player-missile DMA (DMACTL, GRACTL). The transfer of object 
graphics from memory to display is then fully automatic. 

PMBASE specifies the most significant byte (MSB) of the address of 
the player-missile graphics. The location of the graphics for each 
object is determined by adding an offset to PMBASE *256 (decimal). The 
bytes between the base address and the missile data are not used by 
Antic, so they are available to the programmer. 

Only the five most significant bits of PMBASE are used with 
single-line resolution and the six most significant bits are used 
with two-line resolution. This means that the location of the graphics 
in memory is restricted to certain page boundaries. Two-line resolu- 
tion means that each byte of data is repeated for two lines. (see 
DMACTL, bit 4). 640 (decimal) bytes (5X128) are required for two-line 

resolution and 1280 bytes (5x256) for one-line resolution. 

Each byte in the player graphics area represents eight pixels which 
are to be displayed on the corresponding line(s) of the TV screen. A 
1 indicates that the player's color— lum is to be displayed in that pixel. 
The graphics may be anything, not just rectangles like the ones in figure 
II. 3. The player graphics may fill the entire height of the screen or 
they may be only a couple of lines high if the rest of the display data is 
all 0's. Each byte in the missile display also represents eight pixels, 
two pixels for each missile. Each pixel may be 1, 2, or 4 color clocks, 
and is determined by the SIZE registers. 


Playf ield : Playfield is always generated by DMA. There are four 
playfields, each identified by its own color-lum register and collision 
detection. Playfield is generated by two different DMA techniques: 
memory map and character. Both methods provide lists of instructions in 
memory, independent of the player-missile generation. 
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Player-Missile Base Address (PMBASE) = MSB of address 
Resolution is controlled by bit 4 of DMACTL. 


ADDRESS OFFSET 

Two-line One-line 

resolution resolution 
(hex) (hex) 


PMBASE*! 00 (hex' 


3 2 10 


Missile 

Number 


TV SCREEN 


+280 


+380 


POl ^ 
i I M2 


Horizontal position 
"for each object is set 
independently by 8 
horizontal position 
registers . 


Player-Missile 
Vertical screen 
map in memory 


Each section of memory maps directly 
onto total height of TV screen. 

Object vertical position is determined 
only by its location in its section 
of memory. One byte of memory equals 
1 or 2 television lines vertically. 


Figure II. 2 


PLAYER-MISSILE 


DMA 
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Unlike players and missiles, there are no horizontal position registers 
for playfield. Each player can only have one byte of display per line. 
Playfield, on the other hand, may require up to 48 bytes per line because 
it can fill the entire width of the screen. 

There are three different playfield widths: narrow (128 color 
clocks), standard (160 color clocks), and wide (192 color clocks). 

The width is selected by storing into DMACTL. The advantage of a narrower 
width is that less RAM is required and fewer machine cycles are stolen for 
DMA. The OS graphics modes use the standard screen width. 


Display List : The display list is a sequence of display instructions 
stored in memory. These instructions are either one (1) byte or three (3) 
bytes long. The display list can be considered a display program, and the 
Display List Counter that fetches these instructions can be thought of as 
a display program counter. (10 bit counter plus 6 bit base register.) 

The display list counter can be initialized by writing to DLISTH and 
DLISTL. (or OS shadow registers SDLSTH and SDLSTL). Once initialized 
this counter value is used to address the display list, fetch the instruc- 
tion, display one (1) to sixteen (16) lines of data on the TV screen, 
increment the Display List Counter, fetch the next display instruction, 
and so on automatically without microprocessor control (see DLISTL and 
DLISTH). DLISTL and DLISTH should be altered only during vertical blank 
or when DMA is disabled (see DMACTL). 

Each instruction defines the type (alpha character or memory map) and 
the resolution (size of bits on screen) and the location of data in memory 
to be displayed for a group (1 to 16) of lines. Each group of lines is 
called a display block. 

THE DISPLAY LIST CANNOT CROSS A IK BYTE MEMORY BOUNDARY UNLESS 
A JUMP INSTRUCTION IS USED. 


DLISTH (MSB) 

I I I I I I I 

D7 |D6 1 P 5 |D4 1D3 1D2 |D1 |D0 
V J 


DLISTL (LSB) 

I ! I I I I I 

D7 |D6 1 D5 1D4 |P3 ]D2 iDl |D0 I 

v „ / 


\ x 


r 








'N 

1 1 1 1 ! 

15 114 113 112 111 110 

9 

00 


LLJ 

4 

3 

2 

1 

1 J 0... 


Fixed (6 bits) 


Counter (10 bits) 


DISPLAY LIST COUNTER 
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Display Instruction Format : Each instruction consists of either an 
opcode only, or of an opcode followed by two (2) bytes of operand. 


1 Opcode] Single Byte Display Instruction 

1 Opcode! 

1 Operand! / Triple Byte Display Instruction 

1 Operand! 




The opcode is always fetched first and placed in the Instruction 
Register . This opcode defines the type of instruction (1 or .3 bytes) 
and will cause two more bytes to be fetched if needed. If fetched, 
these next two (2) bytes will be placed in the Memory Scan Counter , 
or in the Display List Counter (if the instruction is a Jump). 


Display Instruction Register (IR) : This register is loaded with the 
opcode of the current display list instruction. It cannot be accessed 
directly by the programmer. There are three basic types of display list 
instructions: blank, jump, and display. 

Blank ^ 

(1-byte) [d 7 1 D 6 lD5 |D4 1 01 01 Oi 0 

This instruction is used to create 1 to 8 blank lines on the 
display (blackground color) . 

D7 1 = display list instruction interrupt 

D6 - D4 0-7 = 1-8 blank lines 

D3 - DO 0 = blank 

^mp 

(3-bytes) |P7lD6l Xl Xl 01 01 01 ll 

This instruction is used to reload the Display List Counter. 

The next two bytes specify the address to be loaded (LSB first). 

D7 1 = display list instruction interrupt 

D6 0 = jump (creates one blank line on display) 

1 = jump and wait until end of next vertical blank 
D5-D4 X = don't care 

D3-D0 1 = jump 

Display 

(1 or 3 bytes) |P7lD6lD5lD4lD3lD2lDl iDOl 

This instruction specifies the type of display for the next 
display block. 

D7 1 = display list instruction interrupt 

D6 0=1 byte instruction 

1=3 byte instruction (reload Memory Scan Counter 
using address in next two bytes, LSB first). 

D5 1 = vertical scroll enable 

D4 1 = horizontal scroll enable 

D3-D0 2-F = display mode (memory or character map - 

see following pages). 
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HSCROL 

1 

JXXl 

ixxl 

ixxl 

Dyci 

| XX 

J 

Dye] 

Ixxl 

IXXL 

Horizontal Scrolling 


VSCROL 

1 

1 


m 

mm 

m 

meoi 

J 

1 XX 1 XX 1 

Vertical 

Scrolling 


LD 

MEM SCAN 

1 

] 

1 

J 


J 

J 

J 


Load memory scan (3 

byte) 

INST INTERRUPT 

1 

1 

J 

1 

j 

J 

i 

1 

1 XX | XX 1 XX Ixxl XX I XX 

1 XX Ixxl 

Display 

instruction 

interrupt 

BLK 

1 

1 

| 00 



1 

1 





| 80 







1 1 

1 1 

Blank 1 

line 


it 

2 

| 10 



1 





| 90 







1 1 

Blank 2 

1 ines 


IV 

3-7 

1 



! 












1 1 

Blank 3 

thru 7 lines 


it 

8 

1 70 



1 





j F0 







1 1 

Blank 8 

lines 


JMP 


1 01 



1 





1 81 







1 1 

Jump (3 

byte instruction) 

JVB 


1 41 



1 





1 Cl 







1 1 

Jump & wait for Vert 

. Blank 

CHR 

(40,2,8) 

| 02 

| 12 

| 22 

| 32 

142 

1 52 

| 62 

1 72 

| 82 

| 92 

1 A2 

| B2 

| C 2 

j D 2 

j E2 

1 F 2 | 


(also 3 

byte) 

ft 

(40,2,10) 

! 03 

! 13 

| 23 

! 33 

143 

153 

163 

1 73 

| 83 

I 93 

1 A3 

j B 3 

1 C 3 

j D 3 

j E 3 

| F3 j 




ti 

(40,4,8) 

| 04 

1 14 

1 24 

134 

1 44 

| 54 

]64 

I 74 

1 84 

| 94 

1 A 4 

j B 4 

1 C 4 

j D 4 

j E 4 

1 F4 | 

Character Mode 


ii 

(40,4,16) 

105 

1 15 

1 25 

135 

145 

1 55 

| 65 

1 75 

185 

1 95 

1 A5 

1 B 5 

1 C 5 

| D 5 

| E5 

1 F5 | 

Instruc t ions 


IV 

(20,5,8) 

| 06 

I 16 

| 26 

1 36 

| 46 

1 56 

| 66 

1 76 

186 

| 96 

j A6 

j B 6 

j C 6 

j D 6 

j E 6 

1 F 6 | 




ii 

(20,5,16) 

1 07 

1 17 

1 27 

1 37 

147 

j 5 7 

| 67 

1 77 

187 

197 

1 A7 

j B 7 

| C 7 

1 D 7 

| E 7 

| F 7 | 




MAP 

(40,4,8) 

| 08 

1 18 

| 28 

138 

j 48 

158 

168 

178 

| 88 

|98 

j A8 

j B 8 

j C 8 

j D 8 

j E 8 

1 F8 j 




ii 

(80,2,4) 

I 09 

1 19 

| 29 

| 39 

| 49 

159 

|69 

179 

| 89 

|99 

I A9 

j B 9 

| C 9 

j D 9 

I E 9 

1 F9 | 




ii 

(80,4,4) 

| 0A 

1 1A 

| 2A 

1 3A 

| 4 A 

1 5 A 

| 6A 

1 7 A 

| 8A 

| 9 A 

j AA 

j BA 

| CA 

Ida 

j EA 

1 FA j 




it 

(160,2,2) 

| 0B 

1 IB 

| 2B 

1 3B 

1 4B 

1 5B 

| 6B 

1 7B 

| 8B 

| 9B 

1 AB 

| BB 

| CB 

| DB 

| EB 

1 FB | 

Memory 

Map Mode 


it 

(160,2,1) 

| OC 

1 ic 

j 2C 

1 3C 

1 4C 

1 5C 

1 6C 

1 7 C 

| 8C 

| 9C 

j AC 

j BC 

j CC 

j DC 

j EC 

1 FC j 

Instructions 


II 

(160,4,2) 

| 0D 

1 ID 

1 2D 

1 3D 

1 4D 

1 5D 

1 6D 

1 7D 

| 8D 

| 9D 

| AD 

1 BD 

| CD 

| DD 

| ED 

1 FD 1 




it 

(160,4,1) 

| 0E 

j IE 

j 2E 

| 3E 

1 4E 

1 5E 

| 6E 

1 7 E 

j 8E 

j 9 E 

j AE 

| BE 

1 CE 

j DE 

| EE 

1 fe 1 




it 

£320,2,1) 

1 OF | IF 1 2F I 3F 1 4F 1 5F 1 6F 1 7F I 8F 1 9F 

1 AF IBF 1 CF IDF 1 EF IFF I 





I I 1 


Number 

Number 

Number 


of 

of 

of 


TV lines per cell 

Colors (Background + Playfield types) 
Horizontal cells (standard width screen) 


Figure II. 3 


DISPLAY INSTRUCTION OPCODES 
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Bit 7 of a display list instruction can be set to create a display 
list interrupt if bit 7 of NMIEN is set* The display list interrupt code 
can change the colors or graphics during the middle of the TV display. 

The type of interrupt is determined by checking NMIST. NMIRES clears 
NMIST. The current OS will vector through VDSLST (Hex 200 and 201) to 
the user's display list interrupt routine. See the OS manual for program- 
ming details. 

Bits 5 and 4 of a display type of display list instructions are used 
to enable vertical and horizontal scrolling. The amount of scrolling 
depends on the values in the VSCROL and HSCROL registers (to be described 
later) . 


Memory Scan Counter : This counter is not directly accessible by the 
programmer. It is loaded with the value in the last 2 bytes of a 3 byte 
(non-Jump) instruction. 

This counter points to the location (address) in memory of data to be 
directly displayed (memory map display) or to the location of character 
name strings to be indirectly displayed (character display). 


A single byte instruction does not reload this counter. This implies 
a continuation in memory of data to be displayed from that displayed by 
the previous instruction. Since this counter really consists of 4 bits of 
register and 12 of actual counter, a continuous memory block cannot cross 
4K byte memory boundaries » unless the counter is repositioned with a 3 
byte Load Memory Scan Counter instruction. 

LSB Second byte of 3 
byte instruction 


v ^ / 

/ 




\f 







UHUB 

lUIHiMIUlif lilM 

1 i~ 

18 17 16 

5 

LAJ 

LJJ 

[2J 

1 

10 


Fixed (4 bits) Counter (12 bits) 


7I6I5I4I3I21110 


MSB third byte of 3 byte 
byte instruction 


7 

6 

5 

4 

3 

2 

1 

0 

v 
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Memory Map Display Instructions : Data in memory (addressed by the 
Memory Scan Counter) is displayed directly when executing a memory (bit) 
map display instruction. As data is being displayed it is also stored in 
a shift register so that it can be redisplayed for as many TV lines as 
required by the instruction. 
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Memory Scan Counter 
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mil 
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Shift register data is displayed for four TV scan lines in this example. 


In Instruction Register (IR) display modes 8 through F, one or two 
bits of memory are used to specify what is to be displayed on each pixel 
of the screen. Pixel sizes range from 1/2 clock by 1 TV line to 4 clocks 
by 8 TV lines. The OS and BASIC support most of these graphics modes 
(BASIC GRAPHICS command). Two modes, C and E, are not supported by the 
OS. These modes have rectangular pixels, which are approximately twice as 
wide as they are high. 

In IR mode F, only one color (C0LPF2) can be displayed. Two different 
luminances are available. If a bit is a zero, then the luminance of the 
corresponding pixel comes from C0LPF2. If the bit is a one, them the 
luminance is determined by the contents of C0LPF1 (abbreviated to PF1). 

In IR modes 9,B, and C, two different colors can be displayed. A 
zero indicates background color and a one indicates PFO color. The 
difference between the various modes is in the size of the pixels. 

In IR modes 8,A,D, and E, two bits are used to specify the color 
of each pixel. This allows four different colors to be displayed. 

However, only four pixels can be packed into each byte, instead of eight 
as in the previous modes. The bit assignments are shown below. 


SHIFT REGISTER | 7 6 1 5 4~ 1 3 2 | 1 0 1 7 6 1 5 4 1 3 2 1 1 0 1 


2 bits form 
one pixel 
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Memory Map Display Modes 


I OS 
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| Colors 

|Pixels 

| Bytes 

| Scan 

| Color 
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| Bit 

1 1 

| and 

| Inst. 

1 

per 

1 per 

1 

per 

| Lines 

| Clocks 

|Bits 

| Values 

| Color | 

| BASIC 

|Reg. 

1 

Mode 

| Std. 

| Std. 

1 

per 

1 
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I per 

1 in 

1 Reg. | 

I Modes 
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(Pixel 
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1 
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Character Display Instructions : The first step in using the character 
map mode is to create a character set in memory (or the built-in OS 
character set at hex E000 may be used) • The character set contains eight 
bytes of data for the graphics for each character. The meaning of the 
data depends on the mode. The character set can contain 64 or 128 characters, 
also depending on the mode. The MSB (Most Significant Byte) of the 
address of the character set is stored in CHBASE (or the OS Shadow CHBAS). 

Only the most significant six or seven bits of CHBAS are used (see CHBASE 
description in section III). The other one or two bits and the LSB of the 
address are assumed to be zero, so the character set must start at an 
acceptable page boundary. 

The next step is to set up the display list for the desired mode. 

Then the actual display is set up. This consists of a string of character 
names or codes. Each name takes one byte. The last 6 or 7 bits of the 
name selects a character. For a 64 character set, the name would range 
from 0 through 63 (decimal). For a 128 character set, the range would be 
0 through 127 (decimal). The upper one or two bits of the name byte are 
used to specify the color or other special information, depending on the 
mode. 


Character names (codes) are fetched by the memory scan counter, and 
are placed in a shift register. On any given line of display the shift 
register rotates, changing only the name portion of the character address, 
as shown below. 

After a full line of character data has been displayed the line 
counter will increment. The next line again addresses all characters by 
name for that line number. 

In 20 character per line modes the seven most significant bits of 
CHBASE are used. This requires that the character set to start upon a 512 
byte memory boundary. The set must contain 64 charcters, 8 bytes each, 
giving a total of 512 bytes for the set. 

The 40 character per line modes use the six most significant bits 
of CHBASE, forcing the character set to start on a IK byte memory boundary. 
The set must have 128 characters of 8 bytes each. This gives a total of 
1024 bytes for the set. 
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There are six charcter map modes, IR modes 2 through 7. Modes 2,6 
and 7 are supported by the OS and BASIC (GRAPHICS 0,1 and 2). 

In IR modes 6 and 7, the upper two bits of each character name select 
one of four playfield colors. For each data bit that contains a one, the 
selected playfield color is displayed. For each zero data bit, the 
background color is displayed. The four character colors plus the background 
color gives a total of five different colors, the mode 6 characters are 
eight lines high and the mode 7 characters are sixteen lines high (each 
data byte is displayed for two lines). 

In IR modes 4 and 5, each character is only four pixels wide instead 
of eight (as in the other modes). Two bits per pixel of data are used to 
select one of three playfield colors, or background. Seven name bits are 
used to select the character. If the most significant name bit is a zero 
then data of 10 (binary) selects PF1. If the name bit 7 is one, then data 
bits of 10 select PF2. This makes it possible to display two characters 
with different colors, using the same data but different name bytes. 

In IR modes 2 and 3, each pixel is half of a color clock in width. 

This makes it possible to have forty eight-pixel-wide characters in a 
standard width line. These modes are similar to memory mode F in that two 
luminances can be displayed, but only one color is available at a time. 

In IR mode 3, each character is 10 lines high. This makes it possible to 
define lower case characters with descenders. The last fourth of the 
character set (name bits 5 and 6 equal to one) is lowered. The hardware 
takes the first two data bytes and moves them to the bottom of the character, 
displaying two blank lines at the top of the character (see next page). 

In IR modes 2 and 3, bit 7 of the character name is used for inverse 
video or blanking. This is controlled by CHACTL (Character Control) . If 
bit 2 of CHACTL is a one then all of the characters will be displayed 
upside down, regardless of mode. If CHACTL bit 1 is set, then each 
character which has bit 7 of its name set will be displayed in inverse 
video (the luminances will be reversed). If CHACTL bit 0 is set, then 
each character which has bit 7 set will be blanked (only background wil be 
displayed) . Characters can be blinked on and off by setting name bit 7 to 
1 and toggling CHACTL bit 0. Inverse video and blank apply only to IR 
modes 2 and 3. If both inverse video and blank are set then the character 
will appear as an inverse video blank character (solid square). 


Hardware Collision Detection : 60 bits of collision register are 
provided to detect and store overlap (hits) between players, missiles and 
playfield. These collisions can be read by the microprocessor from 
addresses D000 through D00F. There are no bits for missile to missile 
collisions . 

16 bits for Missile to Playfield 
16 bits for Player to Playfield 
16 bits for Missile to Player 

12 bits for Player to Player (PO to PO always reads as zero, etc.) 


The 1/2 clock memory map mode (IR code 1111) and the 1/2 clock Character 
mode (IR codes 0011 and 0010) are both playfield type 2 collisions and will 
be stored in bit 2 of the playfield collision registers. 
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Vertical and Horizontal Fine Scrolling ; Playfield objects are difficult 
to move smoothly. Memory map playfield can be moved by rewriting sections 
of memory. However, this is extremely time-consuming if large sections 
of the screen mist be moved smoothly. Character playfield objects can be 
moved easily in a jerky fashion by changing the memory scan counter. 

However, this results in a large position jump from one character position 
to another, not a smooth motion. For this reason hardware registers 
(VSCROL and HSCROL) and counters are provided to allow smooth horizontal 
or vertical motion, up to one character width horizontally and up to one 
character height vertically. After this much smooth motion has been 
done by increasing the value in these registers, memory is rewritten or 
the memory scan counter is modified and smooth motion is resumed for 
another character distance. 


Vertical Scrolling : A zone of playfield on the screen can be scrolled 
upward by using VSCROL and bit 5 of the display list instruction. The 
display blocks at the upper and lower boundaries of the zone must have a 
variable vertical size. In particular, the first display block within that 
zone must be shortened from the top, and the last display block must be 
shortened from the bottom (i.e. not all of the top and bottom blocks will 
be displayed) . 

The vertical dimension of each display block is controlled by a 4 bit 
counter within the ANTIC, called the 'Delta Counter' (DCTR) . Without 
vertical scrolling, it starts at 0 on the first line, and counts up to a 
standard value, determined by the current display instruction. (Ex: 
for upper and lower case text display, the end value is 9. For 5 color 
character displays, it is 7 or 15.) 

If bit 5 of the instruction remains unchanged between consecutive 
display blocks, then the second block is displayed in the normal fashion. 

If bit 5 of the instruction goes from 1 to 0 between two consecutive 
display blocks, the second block will start with Delta = 0, as usual, but 
will count up until delta=VSCROL , instead of the standard value. This 
shortens that display block from the bottom. 

To define a vertically scrolled zone, the most direct method is to 
set bit 5 to 1 in the first display instruction for that zone, and in all 
consecutive blocks but the last one. If the VSCROL register is not 
rewrittren on the fly, this results in a total scrolled zone that has a 
constant number of lines (provided that the VSCROL value does not exceed 
the standard individual block size). If N is the standard block size, the 
top block will be N-VSCROL lines (N > VSCROL ) , and the last block will be 
VSCROL + 1 lines: (N-VSCROL) + (VSCROL + 1) = N + 1. Shown on the 
following page is an example of a scrolled zone, top block, for 8 VSCROL 
values for N = 8. 

Horizontal scrolling is described under HSCROL in section III. 
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Simple Display List Example : BASIC starts out in OS graphics mode 0 
which displays 40 characters across by 24 rows. This is IR mode 2 with a 
standard screen width. The OS sets up the display list near the top of 
RAM with room for the character names at the top of RAM. On a 32 K-byte 
machine, the display list would start at hex 7C20. The next three bytes 
are hex 70' s to create 24 blank lines. The next byte is a hex 42. The 
4 tells the hardware to reload the memory scan counter with the following 
address (7C40). This is the address of the data to be displayed. The 2 
tells the hardware to display one line of IR mode 2 characters. The 
next 23 bytes specify 23 more lines of mode 2 characters. Hex 41 is the 
code for jumping and waiting until the end of the next vertical blank. 

The address to jump to is 7C20, the start of the display list. The next 
960 bytes are the list of characters to be displayed, 40 bytes per line. 
The OS must set up the display list pointer (DLISTH and DLISTL) to the 
starting address of the display list (7C20). It also sets CHBASE to the 
MSB of the address of the character set (E0) . 

This is a simple example because only one mode is used and the memory 
scan counter is only loaded at one point. It is possible to have different 
modes on different lines, change character sets and colors, etc., as shown 
in the example in Section IV. 
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OS Mode 0 Display List (40 chars x 24 lines) 


Address (hex) 
7C20 


7C40 


Cycle Counting : As explained previously, the ATARI 800 6502 micropro- 
cessor runs at a rate of 114 machine cycles per TV line (1.79 MHZ). There 
are 262 lines per TV frame and 60 frames per second on the NTSC (IJS) system. 
(The PAL (Europeon) system is different. See the section on NTSC vs. PAL.) 

Each machine cycle is equivalent in length to 2 color clocks. There 
are 228 color clocks on a TV line. The highest resolution graphics modes 
have a pixel size of 1/2 color clock by 1 TV line. Horizontal blank takes 
40 machine cycles. This is when the beam returns to the left edge of the 
screen in preparation for displaying the next TV line. A wait for Sync 
(WSYNC) instruction stops the 6502. The processor is restarted exactly 7 
machine cycles before the beginning of the next TV line. The program can 
thus change graphics or colors during horizontal blank in preparation for 
the next line. 

The ANTIC chip steals cycles from the 6502 in order to do memory 
refresh and fetch graphics data when needed. The general rule to remember 
is that each byte fetched from memory requires one machine cycle. If a 
display list memory map instruction extends over several lines then the data 
is only fetched on the first line. Memory refresh takes 9 cycles out of 
every line, unless pre-empted by a high-resolution graphics mode. Memory 
refresh continues during vertical blank. 

Missile DMA takes one cycle per line in the one-line resolution mode 
and one cycle every 'other line in the two line resolution mode. Missile 
DMA can be enabled without doing player DMA. However, if player DMA is 
enabled then missile DMA will also be done (see DMACTL, GRACTL bits). 

Player DMA requires 4 cycles every one or two lines, depending on the 
resolution used. 


Data (hex) 

70 1 

70 / 24 blank lines 
70 ) 

42 reload memory scan counter with 7C4C 
40 > IR mode 2 
7C ) 

2 'N 
2 
2 


\ 23 more IR mode 2 instructions 


2 
2 

2 J 

41 ’'S Jump back to 7C20 and 
20 / wait for end of vertical blank. 

7C 


y 

) 

} 


960 bytes of display data 
(character names) 
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Each fetch of a display list byte takes one cycle, so three cycles 
are required for a three byte instruction. 

Player/missile and display list instruction fetch DMA take place 
during horizontal blank, if they are required for the next line. 

In memory map modes, the graphics data is fetched as needed throughout 
the first line of the display list instruction, then saved by ANTIC for 
use in succeeding lines. In character modes, the character codes are 
fetched during the first line of each row of characters, along with the 
graphics data needed for that line. On the next lines, only the graphics 
data is fetched, since ANTIC remembers the character codes. 

In the 40 x 24 character mode, with a standard screen width, most of 
the cycles during the top line of each row of characters are requried to 
fetch the character codes and data, so there is only time for one memory 
refresh cycle instead of the usual nine. Less DMA is required with a narrow 
screen width so two memory refresh cycles would occur in this case. 

The memory refresh is done fast enough to make up for the lost cycles 
in the high resolution modes. Once memory refresh starts on a line, it 
occurs every four cycles unless pre-empted by DMA. 

All interrupts reach the 6502 near the end of horizontal blank. 

With standard or narrow screen widths, refresh DMA starts after the end of 
horizontal blank. 

The time at which ANTIC does cycle stealing is deterministic, but 
depends on the graphics mode, screen width and whether or not horizontal 
scrolling is enabled. Horizontal scrolling requires extra graphics data: 
see HSCROL. 

ANTIC does horizontal scrolling of an even number of color clocks by 
delaying the time at which it DMA's the data. To do an odd number of color 
clocks (which involves half of a machine cycle) , ANTIC has a one color clock 
internal delay. 

Theoretically, it is possible to write a program which changes graphics 
or colors "on the fly", i.e. during the middle of a TV line. However, 
with all the DMA going on, the cycle counting gets to be quite complicated, 
and is beyond the scope of this manual. 

There are a number of delays associated with the display of graphics. 
These occur in the ANTIC and the CTIA. The ANTIC sends data to the CITA 
which adds in the color information. Thus the timing for changing colors on 
the fly is different from that for changing graphics on the fly. 
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Horizontal Blank DMA Timing 


When DMA is enabled, cycles are stolen at the times shown below. 
End of 


1 ^Previous 

Horizontal Blank 

| Line 



20 machine cycles (40 color clocks) 


I 4 


I 1 I 1 I 


WSYNC 


t I 2 


8 

A 


1-9 refresh cycles, 
char, and graphics 
data DMA (depends on 
graphic mode) 


Llnterrupt 

Address DMA (3-byte display list 
instruction) 

Player 

Display list instruction fetch DMA 
Missile DMA 


Cycle Counting Example : This example uses the 40 character by 24 line 
display list given on page 11.24. This display list is 32 bytes long so 
display list DMA takes 32 machine cycles. It takes 960 cycles to DMA the 
characters and 8*960 to DMA the character data. The refresh DMA takes 9 


cycles for each of 262 lines, except 
are read, where only 1 refresh cycle 

DMA description 
display list 
characters 
character data 
refresh 
total 

Thus the total DMA per frame is 
is 262 lines with 114 machine cycles 
cycles per frame. Thus 36% of each 
mode 0. 


for the 24 lines where the characters 
occurs . 


Machine cycles 
32 

40x24 = 960 

960x8 =7680 

262x9-24x8 =2166 

10838 

10838 machine cycles. One frame 
per line for a total of 29868 machine 
frame is required for DMA in OS graphics 


NTSC vs. PAL Systems : There are two versions of the ATARI 800: the NTSC 
(United States T.V. standard) and PAL (one of the European T.V. standards). 
The PAL system has been designed so that most programs will run without 
being modified. However, some differences may be noticeable. There is a 

hardware register (PAL) which a program can read to determine which type of 
system it is running on and adjust accordingly. 
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The PAL T.V. has a slower frame rate (50 Hz. instead of 60 Hz.) so 
games will be slower unless an adjustment is made. PAL has more T.V. 
lines per frame (312 instead of 262). The Atari 800 hardware compensates 
for this by adding extra lines at the beginning of vertical blank. Display 
lists do not have to be altered. However, their actual vertical height will 
be shorter. PAL ATARI 800 colors are similar to NTSC because of a hardware 
modification. 


B. POKEY 


Audio : There are 4 semi- independent audio channels, each with its own 
frequency, noise, and volume control. Each has an 8 bit "divide by N" 
frequency divider, controlled by an 8 bit register (AUDFX) . (See audio-serial 
port block diagram.) Each channel also has an 8 bit control register (AUDCX) 
which selects the noise (poly counter) content, and the volume. 


Frequency Dividers : All 4 frequency dividers can be clocked simultane- 
ously from 64 KHZ or 15 KHZ. (AUDCTL bit 0). Frequency dividers 1 and 3 
can alternately be clocked from 1.79 MHZ (AUDCTL bits 6 and 5). Dividers 2 
and 4 can alternately be clocked with the output of dividers 1 and 3 (AUDCTL 
bits 4 and 3). This allows the following options: 4 channels of 8 bits 
resolution, 2 channels of 16 bit resolution, or 1 channel of 16 bit and 2 
channels of 8 bit. 


Poly Noise Counters : There are 3 polynomial counters (17 bit, 5 bit 
and 4 bit) used to generate random noise. The 17 bit poly counter can be 
reduced to 9 bits (AUDCTL bit 7). These counters are all clocked by 1.79 
MHZ. Their outputs, however, can be sampled independently by the four 
audio channels at a rate determined by each channel's frequency divider. 

Thus each channel appears to contain separate poly counters (3 types) 
clocked at its own frequency. This poly counter noise sampling is controlled 
by bits 5,6 and 7 of each AUDCX register. Because the poly counters are 
sampled by the "divide by N" frequency divider, the output obviously cannot 
change faster than the sampling rate. In these modes (poly noise outputted) 
the dividers are therefore acting as "low pass" filter clocks, allowing only 
the low frequency noise to pass. 

The output of the noise control circuit described above consists of 
pure tones (square wave type) , or polynomial counter noise at a maximum 
frequency set by the "divide by N" counter (low pass clock). This output 
can be routed through a high pass filter if desired (AUDCTL bits 1 and 
2 ). 
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Audio Noise Filters: 


VOL 



Any channel noise output (without high pass filter) 

VOL 



Channel 2 output (with high pass filter) 


Clock 
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High Pass Filters : The high pass filter consists of a "D" flip flop 
and an exclusive-OR Gate. The noise control circuit output is sampled by 
this flip flop at a rate set by the "High Pass" clock. The input and output 
of the Flip Flop pass through the exclusive-OR Gate. If the flip flop input 
is changing much faster than the clock rate, the signal will pass easily 
through the exclusive-OR Gate. However, if it is lower than the clock rate, 
the flip flop output will tend to follow the input and the two exclusive-OR 
Gate inputs will mostly be identical (11 or 00) giving very little output. 
This gives the effect of a crude high pass filter, passing noise whose 
minimum frequency is set by the high pass clock rate. Only channels 
1 and 2 have such a high pass filter. The high pass clock for channel 1 
comes from the channel 3 divider. The high pass clock for channel 2 comes 
from the channel 4 divider. This filter is included only if bit 1 or 2 of 
AUDCTL is true. 


Volume Control : A volume control circuit is placed at the output of 
each channel. This is a crude 4 bit digital to analog converter that 
allows selection of one of 16 possible output current levels for a logic 
true audio input. A logic zero audio input to this volume circuit always 
gives an open circuit (zero current) output. The volume selection is 
controlled by bits 0 thru 3 of AUDCX. "Volume Control only" mode can be 
invoked by forcing this circuit's audio input true with bit 4 of AUDCX. In 
this mode the dividers, noise counters, and filter circuits are all discon- 
nected from the channel output. Only the volume control bits (0 to 8 of 
AUDCX) determine the channel output current. 

The audio output of any channel can be completely turned off by writing 
zero to the volume control bits of AUDCX. All ones gives maximum volume. 


C. SERIAL PORT 


The serial port consists of a serial data output (transmission) 
line, a serial data input (receiver) line, a serial output clock line, a 
bi-directional serial data clock line, and other miscellaneous control lines 
described in the Operating System Manual. Data is transmitted and received 
as 8 bits of serial data preceded by a logic zero start bit, and succeeded 
by a logic true stop bit. Input and output clocks are equal to the baud 
(bit) rate, not 16 times baud rate. Transmitted data changes when the 
output clock goes true. Received data is sampled when the input clock goes 
to zero. 


Serial Output : The transmission sequence begins when the processor 
writes 8 bits of parallel data into the serial output register (SEROUT)(see 
audio and serial port block diagram) . When any previous data byte trans- 
mission is finished the hardware will automatically transfer new data from 
(SEROUT) to the output shift register, interrupt the processor to indicate 
an empty (SEROUT) register (ready to be reloaded with the next byte of 
data), and automatically serially transmit the shift register contents with 
start-stop bits attached. If the processor responds to the interrupt, and 
reloads SEROUT before the shift register is completely transmitted, the 
serial transmission will be smooth and continuous. 
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Output data is normally transmitted as logic levels (+4V=true OV=False). 
Data can also be transmitted as two tone information. This mode is selected 
by bit 3 of SKCTL. In this mode audio channel 1 is transmitted in place of 
logic true, and audio channel 2 in place of logic zero. Channel 2 must be 
the lower tone of the tone pair. 

The processor can force the data output line to zero (or to audio 
channel 2, if in two tone mode) by setting bit 7 of SKCTL. This is required 
to force a break (10 zeros) code transmission. 


Serial Output Clock : The serial output data always changes when the 
serial output clock goes true. The clock then returns to zero in the center 
of the output data bit time. 

The baud (bit) rate of the data and clock is determined by audio 
channel 4 audio channel 2, or by the input clock, depending on the serial 
mode selected by bits 4, 5, and 6 of SKCTL. (See chart at end of this 
section. ) 


Serial Input : The receiving sequence begins when the hardware has 
received a complete 8 bit serial data word plus start and stop bits. This 
data is automatically transferred to the 8 bit parallel input register 
(SERIN), and the processor is interrupted to indicate an input data byte 
ready to read in SERIN. The processor must respond to this interrupt, and 
read SERIN, before the next input data word reception is complete, otherwise 
an input data "over-run" will occur. This over-run will be indicated by bit 
5 of SKSTAT (if bit 5 of IRQST is not RESET (true) before next input complete) , 
and means input data has been lost. This bit should be tested whenever 
SERIN is read. Bit 7 of SKSTAT should also be tested to detect frame errors 
caused by extra (or missing) data bits. 


Direct Serial Input : The serial data input line can be read directly 
by the microprocessor if desired, ignoring the shift register, by reading 
bit 4 of SKSTAT. 


Bi-Directional Clock : This clock line is used to either receive a 
clock from an external clock source for clocking transmitted or received 
data, or is used to supply a clock to external devices indicating the 
transmit or reception rate. This clock line direction is determined 
by the serial mode selected by bits 4, 5, and 6 of SKCTL. (See mode chart 
at the end of this section.) Transmitted data changes on the rising edge of 
this clock. Received data is sampled on the trailing edge of this clock. 


Asynchronous Serial Input : Unclocked serial data (at an approximately 
known (+5%) rate) can be received in the asynchronous modes. The receive 
(input) shift register is clocked by audio channel 4. Channels 3 and 
4 should be used together (AUDCTL bit 3=1) for increased resolution. 

In asynchronous modes, channels 3 and 4 are reset by each start bit at the 
beginning of each serial data byte. This allows the serial data rate to be 
slightly different from the rate set by channels 3 and 4. 
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Serial Mode Control : There are 6 useful modes (of the possible 8) 
controlled by bits 4, 5, and 6 of SKCTL. These are described on the next 
page. 


Note that two tone output (bit 3 of SKCTL) may be used in any of these 
modes except for the bottom pair. This is because channel 2 is used to set 
the output transmit rate and is therefore not available for one of the two 
tones . 

Note that the output clock rate is identical to the output data rate. 


Serial Mode Control (see also register description SKCTL) : 
Force Break 


|D7|D6|D5|D4|D3|D2|DllD0| 

1 1 1 1 


SKCTL REGISTER 

i i 

1 I 

1 1 

1 1 

1 1 

1 1 




Pot scan and keyboard CTRL 

I I 

1 1 

1 | 

1 1 

1 1 

1 1 


Two Tone Control 


1 1 

1 1 

1 1 

1 1 

1 1 

| | Mode Control Bits 

1 1 

1 J 

A=asynchronous 

BIB 

■s a 

1 

Out 

1 

In 

| Bi-Dir 

1 1 
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Rate! Clock 
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1 1 

I 1 

1 
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1 
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L 


1 
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1 
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I 
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1 


1 
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1 
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1 
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i 
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n 


1 1 

| | Chan 
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! 
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Two tone (bit3) not useable in these modes 
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D. INTERRUPT SYSTEM 


There are two basic types of interrupts defined on the microprocessor: 
NMI (non maskable interrupt) and IRQ (interrupt request). It is recommended 
that a thorough understanding of these interrupt types be acquired by 
reading all chapters concerning interrupts in the 6502 microprocessor 
programming and hardware manuals. 

In this system NMI interrupts are used for video display and reset. 

IRQ interrupts are used for serial port communication, peripheral devices, 
timers, and keyboard inputs. 


NMI Interrupts : Even though NMI interrupts are "unmaskable" on 
the micrprocessor , this system has interrupt enable (mask) bits for NMI 
function. (Bits 6 and 7 of NMIEN) When these bits are zero NMI interrupts 
are disabled (masked) and prevented from causing a microprocessor NMI 
interrupt. (see NMIEN register description) The 3 types of NMI interrupts 
are : 

1. D7 = Instruction Interrupt (during display time any display 

instruction with bit 7=1 will cause this interrupt to occur 
(if enabled) at the start of the last video line displayed by 
that instruction.) 

2. D6 = Vertical Blank Interrupt (interrupt occurs (if enabled) at 

the beginning of the vertical blank time interval.) 

3. D5 = Reset Button Interrupt (pushing the SYSTEM RESET button will 

cause this interrupt to occur.) 

Since any of these interrupts will cause the processor to jump to the 
same NMI address, the system also has NMI status bits which may be examined 
by the processor to determine which source caused the NMI interrupt. Bits 
5, 6, and 7 of NMIST serve this function (see NMIST register description). 

These status bits are set by the corresponding interrupt function (even if 
the interrupt is masked from the processor by NMIEN). The status bits may 
be reset together by writing to the address NMIRES. 

Two of the interrupt enable bits (bits 6 and 7 of NMIEN) are cleared 
automatically during system power turn on and therefore these NMI interrupts 
are initially disabled (masked) , preventing any power turn on service routine 
from being interrupted before proper initialization of registers and pointers.* 
They can then be enabled by the processor whenever desired, by writing into 
bits 6 and 7 of NMIEN. Except for the reset button interrupt, they can also 
be disabled by the processor by writing a zero into bits 6 or 7 or NMIEN. 

The reset button cannot be disabled, allowing an unstoppable escape from any 
possible "hangup" condition. 

These NMI interrupt functions are each separated in time (to prevent 
overlaps) and converted to pulses by the system hardware, in order to supply 
NMI transitions required by the microprocessor logic. 


* - NOTE: Bit 5 is never disabled and therefore the Reset Button 
should not be pressed during power turn on. 
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IRQ Interrupts : IRQ interrupts are all "maskable” together by one bit 
of the status register on the microprocessor. This bit is set to the 
disable condition automatically by power turn on to prevent interrupt of 
power turn on service routines.** In addition to this processor IRQ mask 
bit, there are separate system IRQ interrupt enable bits for each IRQ 
interrupt function (bits 0 thru 7 of IRQEN). These bits are not initialized 
by power turn on, and must be initialized by the program before enabling the 
processor IRQ. The 8 types of IRQ interrupts are: 

D7 = BREAK KEY (depression of the break key) 

D6 = OTHER KEY (depression of any other key) 

D5 * SERIAL INPUT READY (Byte of serial data has been received and is 
ready to be read by the processor in SERIN register) . 

D4 = SERIAL OUTPUT NEEDED (Byte of serial data is being transmitted and 
SEROUT is ready to be written to again by the processor) . 

D3 = TRANSMISSION FINISHED (serial data transmission is finished. 

Output shift register is empty) . 

D2 = TIMER #4 (audio divider #4 has counted down to zero) 

D1 = TIMER #2 (audio divider #2 has counted down to zero) 

DO = TIMER #1 (audio divider #1 has counted down to zero) 

In addition to the above IRQ interrupts (enabled by bits 0 through 7 of 

IRQEN and identified by status bits 0 thru 7 of IRQST) there are two more 
system IRQ interrupts which are generated over the serial bus Proceed and 
Interrupt lines. 

D7 of PACTL = peripheral "A" interrupt status bit 

DO of PACTL = peripheral "A" interrupt enable bit 

D7 of PBCTL = peripheral "B" interrupt status bit 

DO of PBCTL = peripheral "B" interrupt enable bit 

These last two interrupts are automatically disabled by power turn on, 
and their status bits are reset by reading from port A register and port B 
register. (See PORTA, PACTL, PORTB, and PBCTL Register descriptions.) 

The IRQEN register, like the NMIEN register, enables interrupts 
when its bits are 1 (logic true). The IRQST however (unlike the NMIST) has 
interrupt status bits that are normally logic true, and go to zero to 
indicate an interrupt request. The IRQST status bits are returned to logic 
true only by writing a zero into the corresponding IRQEN bit. This will 
disable the interrrupt and simultaneously set the interrupt status bit to 
one. Bit 3 of IRQST is not a latch and does not get reset by interrupt 
disable. It is zero when the serial out is empty (out finished) and true 
when it is not. 


** - NOTE: An NMI also disables the I bit. 
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INTERRUPT SUMMARY 


1 

J_ 

1 

NAME | 

FUNCTIONS 

1 

| ENABLE 

I STATUS 

STATUS | 

RESET | 

1 

1 

1 

1 

Display 

1 

1 NMIEN 

I NMIST 

Address | 

1 

NMI | Instruction 

| (Bits 6 thru 7) 

j (Bits 5 thru 7) 

NMIRES | 

I INTERRUPTS | Vert . Blank 

| Normally Zero 

| Normally Zero 

(Resets all NMI j 

1_ 

|Reset Button 

I (Disabled) 

j (no interrupt) 

status together) | 

1 

1 

I 

1 

KEYS 

1 

| IRQEN 

| IRQ ST 

Reset (to true) | 

1 

1 

Serial 

| (Bits 0 thru 7) 

| (Bits 0 thru 7) 

By Zero in | 

1 

1 

ports 

| zero is 

| Normally True 

Corresponding | 

1 

1 

Timers 

| (Disabled)* 

j (no interrupt) 

Bit of IRQEN | 

1 



_L 

! 1 (except Bit 3)* I 

1 

IRQ 1 


1 

1 

1 

1 INTERRUPTS | 

Peripheral 

| DO of PACTL 

| D7 of PACTL 

Reset by \ 

1 

1 

A 

| Normally Zero 

(Normally Zero 

Reading PORT A j 

1 



j (Disabled) 

I (no interrupt) 

Register 1 

! 

1 

1 

1 

Peripheral 

1 

| DO of PBCTL 

1 

| D7 of PBCTL 

Reset by | 

1 

! 

B 

| Normally Zero 

| Normally Zero 

Reading PORT B j 


L 


| (Disabled) 

| (no interrupt) 

Register | 


E. CONTROLLERS 


A variety of controllers can be plugged into the four jacks on the 
front of the console. This includes joysticks, paddle (pot), twelve-key 
keyboard, and light pen (when available). 

The controller ports are read through the PORTA and PORTB regisers 
and the POT and TRIG registers. The OS reads these registers during 
vertical blank and stores into its own RAM locations. These are STICK, 
PADDLO through PADDL7, PTRIG'S and STRIG'S. The OS sets up PORTA AND 
PORTB for input. This is done by setting PACTL or PORTB (Port Control) 
bit 2 to a 0 (to select the direction control register), then writing all 
0's to the desired port. PACTL (PBCTL) bit 2 is then changed back to 
a 1, allowing the program to read from the port. The ports can also be 
set up for output by writing l's instead of 0's while the direction control 
mode is selected. 


Joysticks : The joysticks have four switches, one each for right (R) , 
left (L), back (B) and forward (F) . 

These switches are read through PORTA and PORTB. A fifth switch is 
activated by pressing the red trigger button. The trigger buttons are 
read from TRIGO through TRIG3. A value of 0 indicates that a button has 
been pressed and a 1 indicates that it has not been pressed. 
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The TRIG registers are normally read directly, but they can be used 
in a latched mode. Writing a zero to bit 2 of GRACTL disables the latches 
and sets them to 1. Writing a 1 to bit 2 enables the latches. If a joy- 
stick trigger button is pushed at any time while bit 2 of GRACTL is 1 
the latch value will change to zero and stay that way. A program can 
use this to determine whether the joystick trigger buttons have ever been 
pressed during a certain period of time. 


Paddles : The paddles come in pairs, so eight paddles can be connected 
to the four jacks. The paddles are read by storing into POTGO, then 
reading the POT registers at least 228 lines later. The values range from 0 
(with the paddle turned to the right) to 228 (paddle turned counter-clockwise) . 
The value indicates how many TV lines it takes to charge up the capacitor 
which is the series with the potentiometer. Turning the knob to the right 
lowers the resistance, so the capacitor charges up quickly. Turning the 
knob to the left increases the resistance and the charging time. The 
capacitor dump transistors are used to discharge the capacitors so that a 
new reading can be mode. The POTGO command clears the counters and turns 
off the dump transistors to allow the capacitors to charge up. The ALLPOT 
register contains one bit for each paddle. When the capacitor has charged 
up to the threshold value the ALLPOT bit changes fron one to zero and the 
POT register contains the correct readings. Bit 2 of SKCTL (Serial Port 
Control) enables fast pot scan. In this mode, It takes only two scan lines 
to charge up the capacitors to the maximum level instead of 228 lines. Bit 
2 is first set to 0 to dump the capacitors. Then Bit 2 is set to 1 to start 
the pot scan. The fast pot scan is not as accurate as the normal scan mode. 

Bit 2 of SKCTL must be set to 0 to use normal scan mode. Otherwise, the 
capacitors will never dump. Note that some paddles have a range smaller 
than 0 to 228 due to differences in the pots. The left and right paddle 
triggers for each paddle pair are read from the left and right bits for the 
corresponding joystick (PORTA or PORTB) . 


Keyboard Controllers : Each keyboard controller has a twelve-key pad 
and plugs into a joystick controller port. The first step in using the 
keyboard is to select a row by setting the port direction to output and 
writing a 0 to the bit in the PORTA or PORTB register which selects the 
desired row (see PORTA, SECTION III). The other rows should have l's 
written to them. Columns are read through the POT and TRIG registers (see 
controller PORT PINOUT chart in section III). Appendix H of the BASIC 
Reference Manual contains a Basic program which reads the controllers. The 
first and second columns of the keyboard use the same pins as the pots for 
the paddle controllers, so they are read by reading the POT (or PADDL) 
registers. When a button is pushed, the pot line is grounded, so the pot 
capacitors never charge up to the threshold level and the reading is 228 
(the maximum). When the button in the selected row and column is not pushed 
the capacitor is connected to +5V through a relatively small resistor, 
giving a POT value of about 2 (this may vary). Since the reading is not 
critical, the fast pot scan mode can be used, so that only a 2 line wait is 
required between selecting the row and reading the POT register. The 
convention has been adopted of comparing the POT reading with 10 (decimal). 
If is it greater than 10 then the button has been pressed. The third 
column is read through the joystick trigger line, so it works just like a 
joystick trigger (0=button is pressed, l=not pressed). 
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Light Pen : A light pen is a device that can detect the electron beam 
as it sweeps across the TV screen. It is used to point directly at an image 
on the TV display. Applications include selecting menu items and drawing 
lines. The ATARI 400/800 hardware was designed so that a light pen can be 
plugged into any of the joystick controller ports (see end of section 
III). 


When any one of the joystick trigger lines (pin 6) is pulled low, the 
ANTIC chip takes the current VCOUNT value and stores it in PENV. The 
horizontal color clock value (0-227 decimal) is stored in PENH. The least 
significant bit is inaccurate and should be ignored. Since there are a 
number of delays involved in displaying the data and changing the light 
pen register, each system must be cal brated. Software which uses the 
light pen should contain a user-interactive calibration routine. For 
example, the user could point the light pen at a crosshair in the center 
of the screen and the program could compute the required horizontal offset. 
PENH will wrap around from 227 to 0 near the right hand edge of a standard 
width display because of the delay. The pen will not work if it is pointed 
at a black area of the screen, since the electron beam is turned off. It is 
a good idea to read two (or more) values and average them, since the user 
will probably not hold the pen perfectly steady. 
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III. HARDWARE REGISTERS 


This section lists the hardware registers and Operating System (OS) 
shadow registers. 

In the following descriptions, true always refers to a bit whose value 

is 1. 


A. PAL (D014) 


Not 

Used 


| D3 

I 

| D2 | Dl |Not 
i I lUsed 


D3 

D2 

Dl 



1 

1 

1 

NTSC (US TV) 

0 

0 

0 

PAL (European TV) 


This byte can be read by a program to determine which type of system 
the program is running on. 

B. INTERRUPT CONTROL 

NMIEN (Non Maskable Interrupt Enable) (D40E) : This address writes data 
to the NMI interrupt enable bits. 

0 = disabled (masked) 

1 = enabled 



1 

Not 

D7 

D6 1 

Used 


D7 Display List Instruction Interrupt Enable. This bit is 

cleared by Power Reset, and may be set or cleared by the 
processor. 

D6 Vertical Blank Interrupt Enable. This bit is cleared by Power 
Reset, and may be set or cleared by the processor. 

SYSTEM RESET Button Interrupt 

This interrupt is always enabled. The SYSTEM RESET button should 
not be pressed during power turn on. 

(Set to hex 40 by OS IRQ code.) 
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NMIST (Non Maskable Interrupt Status) (D40F) : This address read the NMI 
Status Register (Read by OS NMI code) . 

0 = no interrupt 

1 = interrupt 



1 

1 1 

Not 

D7 

|D6 

U5J 

Used 


D7 This bit identifies an NMI interrupt caused by bit 7 of a 
Display List Instruction. 

D6 This bit identifies an NMI interrupt caused by the beginning 
of vertical blank. 

D5 This bit identifies an NMI interrupt caused by the SYSTEM 
RESET button. 


NMIRES (NMI Status Register Reset ) (D40F) : This write address resets 
the Non Maskable Interrupt Status Register (NMIST) . 


Not 

Used 


( Written by OS NMI code.) 

IRQST (IRQ Interrupt Status) (D20E) : This address reads the data from 
the IRQ Interrupt Status Register. 

0 = Interrupt 

1 = No Interrupt 


D7 1 D6 I D5 1 D4 I D3 I D2 1 D1 I DO 


D7 = 0 Break Key Interrupt 

D6 = 0 Other Key Interrupt 

D5 = 0 Serial Input Data Ready Interrupt 

D4 = 0 Serial Output Data Needed Interrupt 

D3 = 0 Serial Output (Byte) Transmission Finished Interrupt * 

D2 = 0 Timer 4 Interrupt 

D1 = 0 Timer 2 Interrupt 

DO = 0 Timer 1 Interrupt 


* - NOTE: Used for generation of 2 stop bits. See IRQ description 
in section II (no direct reset on bit 3). 
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IRQEN (IRQ Interrupt Enable) (D2QE) : This address writes data to the IRQ 
Interrupt Enable bits. 

0 = disable, corresponding IRQST bit is set to 1 

1 = enable 


D7 I D6 | D5 1 D4 1 D3 1 D2 1 D1 I DO 


D7 Break Key Interrupt Enable 

D6 Other Key Interrupt Enable 

D5 Serial Input Data Ready Interrupt Enable 

D4 Serial Output Data Needed Interrupt Enable 

D3 Serial Out Transmission Finished Interrupt Enable 

D2 Timer 4 Interrupt Enable 

D1 Timer 2 Interrupt Enable 

DO Timer 1 Interrupt Enable 

OS SHADOW: POKMSK (hex 10) 

Use AND's and OR's to change one bit in POKMSK without affecting 
the others. Store the desired value in both IRQEN and POKMSK. 


C. TV LINE CONTROL 


VCOUNT (Vertical Counter) (D40B) : This address reads the Vertical TV 
Line Counter (8 most significant bits). 


D7 I D6 I D5 1 D4 I D3 1 D2 I D1 I DO I 
V8 V7 V6 V5 V4 V3 V2 VI VO 


VO not read. 
Two line 
resolution 
supplied . 


WSYNC (Wait for Horizontal Blank Synchronism - i.e. wait until start of 
next TV line. ) (D40A) : 


not used 


This address sets a latch that pulls down on the RDY line to the 
microprocessor, causing it to wait until this latch is automatically reset 
by the beginning of horizontal blank. Display list interrupts may be 
delayed by 1 line if WSYNC is used. (Used by OS keyboard click routine.) 
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D 


GRAPHICS CONTROL 


DMACTL (Direct Memory Access Control) (D400) : This address writes data 
into the DMA Control Register. 


Not 

1 





1 

Used 

1 P5 

D4 

D3 

| D2 

IDI 

I DO 


D5 

= 

1 

Enable instruction fetch DMA 

D4 

= 

1 

1 Line P/M resolution 

D4 

= 

0 

2 line P/M resolution 

D3 

= 

1 

Enable Player DMA 

D2 

= 

1 

Enable Missile DMA 

D1,D0 

= 

0 

0 No Playfield DMA 


= 

0 

1 Narrow Playfield DMA 
(128 Color Clocks) 


= 

1 

0 Standard Playfield DMA 
(160 Color Clocks) 


= 

1 

1 Wide Playfield DMA 


(192 Color Clocks) 

See GRACTL. OS Shadow: SDMCTL (22F) default value hex 22 


GRACTL (Graphics Control) (D01D) : This address writes data to the 
Graphic Control Register. 


Not 

1 

I 

1 

Used 

1 D2 

IDI 

1 DO 


D2 = 1 Enable latches on TRIGO - TRIG3 inputs (latches are 

cleared and TRIGO - TRIG3 act as normal inputs when this 
control bit is zero) . 

D1 = 1 Enable Player DMA to Player Graphics Registers. 

DO = 1 Enable Missile DMA to Missile Graphics Registers. 

DMA is enabled by setting bits in both DMACTL and GRACTL. Setting 
DMACTL only will result in cycles being stolen but no display will be 
generated. 
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CHACTL (Character Control) (D401 ) : This address writes data into the 
Character Control Register. 


Not 

1 

1 

1 

Used 

1 D2 

Ljdi 

1 DO 


D2 Character Vertical Reflect Bit. This bit is sampled at the 
beginning of each line of characters. If true it causes the 
line of characters to reflect (invert) vertically (for upside 
down characters). 

D1 Character Video Invert Flag (used for 40 Character Mode 

only) . If bit 7 of character code is true this flag causes 
that character to be blue on white (if normal colors are 
white on blue) . 

DO Character Blank (Blink) Flag (used for 40 Character Mode 

only) . If bit 7 of character code is true this flag causes 
that character to blank. Blinking characters are produced by 
setting bit 7 of the characters to 1, then periodically 
changing DO of CHACTL. 

OS SHADOW: CHACT (2F3) 


DLISTL( Display List Low )(D402) : This address writes data into the 
low byte of the Display List Counter. 


Display 

List 

Counter 

Bit 

Position. 


DLISTH (Display List High)(D403) : This address writes data into the 
high byte of the Display List Counter. 


I D7 | D6 1 D5 1 D4 I D3 1 D2 I D1 1 DO I 

{ Display 

15 14 13 12 11 10 9 8 I List 

< Counter 
Bit 

^Position. 

OS SHADOW: SDLSTH (HEX 231) 

The Display List is a list of display instructions in memory. These 
instructions are addressed by the Display List Counter. Loading these 
registers defines the address of the beginning of the Display List. (See 
sections I and II.) 

Note: The top 6 bits are latches only and have no count capability, therefore 

the display list can not cross a IK byte memory boundary unless a .jump 
instruction is used. 


D7 

1 

I D6 

1 

1 D5 

1 

1 D4 

i 

1 D3 

1 

I D2 

1 

1 D1 

1 

1 DO 

7 

6 

5 

4 

3 

2 

1 

0 


OS SHADOW: SDL STL (hex 230) 
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DLISTL and DLISTH should be changed only during vertical blank or with 
DMA disabled. Otherwise, the screen may roll. Bit 7 of NMIEN must be set 
in order to receive display list interrupts. 


CHBASE (Character Address Base Register) (D409) : This address writes 
data into the Character Address Base Register. The data specifies the most 
significant byte (MSB) of the address of the desired character set (see 
section II). Note that the last 1 or 2 bits are assumed to be 0. 

40 Character Modes 


D7 |D6 |D5 |D4 lD3 |D2 


CHBASE 



9 I 8 


6 I 5 


Base Address 


Char Name 


3 I 2 


Line Counter 


20 Character Modes 


I D 7 [P6 1D5 |D4 lD3 lD2 iDl i* 


CHBASE 


15 114 113 112 111 110 I 9 I 8 


6 I 5 


Base Address 


Char Name 


3 I 2 


Line Counter 


OS SHADOW: CHBAS (2F4) 


PMBASE (Player-Missile Address Base Register) (D407) : This address 
writes data into the Player-Missile Address Base Register. The data 
specifies the MSB of the address of the player and missile DMA data (see 
section II) . 

One Line Resolution 


D7 |D6 |D5 |D4 |D3 I not used 


PMBASE 


Base Address 


Player-Missile 

Select 


Player-Missile Scan 
Counters 


Two Line Resolution 


ID 7 [D6 Id 5 |D4 |D3 | D 2 


PMBASE 


15 114 113 112 111 1 10 I 9 I 8 


6 I 5 


3 I 2 I 1 I 0 


Base Address 


Player-Missile Player-Missile Scan 
Select Counter 


* = Not Used 
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HSCROL (Horizontal Scroll Register ) (D404) : This address writes data 
into the Horizontal Scroll Register. Only playfield is scrolled, not 
players and missiles. 


not used 

1 

! 

1 

1 


1 D3 

|D2 

IDI 

1 DO 


0 to 15 color 
clock right shifts 

The display is shifted to the right by the number of color clocks 
specified by HSCROL for each display list instruction that contains a 1 in 
its HSCROL Flag bit (bit 4 of instruction byte) . 

When horizontal scrolling is enabled, more bytes of data are needed. 
For a narrow playfield (see DMACTL bits 1 and 0) there should be the same 
number of bytes per line as for standard playfield with no scrolling. 
Similarly, for standard playfield use the same number of bytes as for the 
wide playfield. For wide playfield, there is no change in the number of 
bytes and background color is shifted in. 


VSCROL (Vertical Scroll Register) (D405) : This address writes data into 
the Vertical Scroll Register. 


not used 

i i 

1 D2 | 

D1 

1 

1 DO 

8 

line display modes 



not used 

1 1 1 

1 D3 1 D2 I 

D1 

1 

1 DO 

16 

line display modes 




The display is scrolled upward by the number of lines specified in 
the VSCROL register for each display list instruction that contains a 1 in 
its VSCROL Flag bit (bit 5 of instruction byte). The scrolled area will 
terminate with the first instruction having a zero in bit 5. (see section 
II for more details). 


PRIOR (Priority) (D01B) : This address writes data into the Priority 
Control Register. 


D7 I D6 I D5 1 D4 1 D3 1 D2 1 D1 1 DO 


D7-D6 = 0 D5 

Multiple Color Player Enable. 

This bit causes the logical "or" function of the bits of 
the colors of Player 0 with Player 1, and also of Player 2 
with Player 3. This permits overlapping the position of 2 
players with a choice of 3 colors in the overlapped region. 
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D4 Fifth Player Enable . 

This bit causes all missiles to assume the color of Playfield 
Type 3. (C0LPF3) . This allows missiles to be positioned 
together with a common color for use as a fifth player. 


D3, D2, Dl, Priority Select (Mutually Exclusive). 

& DO These bits select one of 4 types of priority. Objects with 

higher priority will appear to move in front of objects 
with lower priority. 


D3=l D2=l Dl=l D0=1 



NOTE ; The use of Priority bits in a "non-exclusive" mode (more than 1 

bit true) will result in objects (whose priorities are in conflict) 
turning BLACK in the overlap region. 

EXAMPLE ; PRIOR code = 1010 This will black P0 or PI if they are over 

PFO or PF1. It will also black P2 or P3 if they are over PF2 or 
PF3. In the one-color 40 character modes, the luminance of a 
pixel in a character is determined by C0LPF1, regardless of the 
priority. If a higher priority player or missile overlaps the 
character then the color is determined by the player's color. 

OS SHADOW: GPRIOR (26F) 


COLPFO - C0LPF3 (Playfield Color) (D016, D017, D018, D019) : These 
addresses write data to the Playfield Color-Lum Registers. 


1 D7 I D6 I D5 | D4 I D3 1 D2 I Dl 1 DO 
(see COLBK for bit assignment) 

OS SHADOWS; COLORO - 3 (2C4-2C7) 
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COLBK (Background Color) (D01A) : This address writes data to the 
Background Color-Lum Register. 


Color Luminance 


D7 

D6 

D5 

D4 

1 1 

D3 1 D2 1 D1 

Not 

Used 

X 

X 

X 

X 

0 0 0 

2 





0 0 1 






ETC. 






1 1 1 

> 

0 

0 

0 

0 

Grey 

0 

0 

0 

1 

Gold 

0 

0 

1 

0 

Orange 

0 

0 

1 

1 

Red-Orange 

0 

1 

0 

0 

Pink 

0 

1 

0 

1 

Purple 

0 

1 

1 

0 

Purple-Blue 

0 

1 

1 

1 

Blue 

1 

0 

0 

0 

Blue 

1 

0 

0 

1 

Light-Blue 

1 

0 

1 

0 

Turquoise 

1 

0 

1 

1 

Green-Blue 

1 

1 

0 

0 

Green 

1 

1 

0 

1 

Yellow-Green 

1 

1 

1 

0 

Orange-Green 

1 

1 

1 

1 

Light-Orange 


Luminance (black) 


Luminance (white) 


OS SHADOW: COLOR 4 (2C8) 

E. PLAYERS AND MISSILES 

DMACTL, GRACTL, PMBASE and PRIOR also affect players and missiles. 

COLPMO - C0LPM3 (Player-Missile Color) (DQ12, DQ13, D014, D015 ) : These 
addresses write to the Player-Missile Color-Lum Registers. Missiles have 
the same color-lum as their player unless missiles are used as a 5th player 
(see bit 4 of PRIOR). A 5th player missile gets its color from C0LPF3. 


D7 

1 

I D6 

1 

1-DA- 

1 

1 D4 

[ 

1 D3 

1 

I D2 

1 

LD1 

1 

1 DO 


(see COLBK for bit assignments) 


OS SHADOWS: PCOLRO - 3 (2C0-2C3) 

GRAFPO - GRAFP3 (Player Graphics Registers): (PO POOD, PI DOPE, P2 POOF , 
P3 D010) : These addresses write data directly into the Player Graphics 
Registers, independent of DMA. If DMA is enabled then the graphics registers 
will be loaded automatically from the memory area specified by PMBASE (see 
page II. 3) . 


I D7 1 D6 I D5 I D4 I P3 1 D2 1 D1 | DO I 
Left Right 

Player on TV Screen 
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GRAFM (Missile Graphics Registers) (D011) : This address writes data 
directly into the Missile Graphics Register, independent of DMA. 


D7 

D6 

D5 

1 

D4 

D3 

D2 

D1 

1 

1 DO 


R^ 


R^ 




R^ 


M3 M2 Ml MO 


SIZEPO - SIZEP3 (Player Size) (PO D008, PI D009, P2 DOOA, P3 DOOB) : 
These addresses write data into the Player Size Control Registers. 


Not 

Used 

D1 

DO 

Horizontal Size 

Register (Player) 


0 

0 

Normal Size 
(8 color clocks wide) 


0 

1 

Twice Normal Size 
(16 color clocks wide) 


1 

0 

Normal Size 


1 

1 

4 Times Normal Size 
(32 color clocks wide) 

With normal size objects, 

each 

bit in the graphics register corresponds 


to one color clock. For larger objects, each bit is extended over more than 
one color clock. 

SIZEM (Missile Size)(D00C) : This address writes data into the Missile 
Size Control Register. 


1 

D7 1 D6 

1 

D5 I D4 

1 

D3 1 D2 

1 

D1 I DO 

M3 

M2 

Ml 

MO 


Horizontal Size 
Register (Missile) 


0 

0 

1 


0 Normal Size 

(2 color clocks wide) 

1 Twice Normal Size 

(4 color clocks wide) 
0 Normal Size 


1 


4 Times Normal Size 
(8 color clocks wide) 


HPOSPO - HP0SP3 (Player Horizontal Position) (PO D000, PI D001, P2 D002, 
P3 D003) : These addresses write data into the Player Horizontal Position 
Register (see display diagram in section IV). The horizontal positon value 
determines the color clock location of the left edge of the object. Hex 30 
is the left edge of a standard width screen. Hex DO is the right edge of a 
standard screen. 


D7 1 D6 1 D5 1 D4 1 D3 1 D2 I D1 1 DO 
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HPOSMO - HPOSM3 (Missile Horizontal Position) (MO D004, Ml D005, 

M2 D006, M3 D007) : These addresses write data into the Missile Horizontal 
Position Registers (see HPOSPO description). 


D7 

1 

I D6 

D5 

1 

1 D4 1 D3 

1 D2 

i i 

1 Dll 

DO 


VDELAY (Vertical Delay) (D01C) : 

This 

Vertical Delay Register. 




D7 

1 

1 D6 

D5 

! 

1 D4 | D3 

D2 

1 1 
1 D1 | 

DO 

P3 

P2 

PI 

P0 M3 

M2 

Ml 

MO 


VDELAY is used to give one-line resolution in the vertical po- 
sitioning of an object when the 2-line resolution display is enabled. 
Setting a bit in VDELAY to 1 moves the corresponding object down by one 
TV line. 

If player-missile DMA is enabled then changing the vertical location 
of an object by more than one line is accomplished by moving bits around 
in the memory map. If DMA is disabled then the vertical location can be 
set up by assembly language code which stores data into the graphics 
registers at the desired line. 

MOPF, M1PF, M2PF » M3PF (Missile to Playfield Collisions) (D000 , D001, 
D002, D003) : These addresses read Missile to Playfield Collisions. 

A 1 bit means that a collision has been detected since the last HITCLR. 


Not Used 

till 

(zero forced) 

1 D3 I D2 | D1 I DO 


3210 Playfield Type 

POPF, P1PF, P2PF , P3PF (Player to Playfield Collisions) (D004 , 

D005, D006, D007) ; These addresses read Player to Playfield Collisions. 


Not Used 

1 1 I 

1 

(zero forced) 

1 D3 1 D2 I D1 

I DO 


3210 Playfield Type 

MOPL » M1PL, M2PL , M3PL (Missile to Player Collision) (D008 , D009, 
D00A, D00B) : These addresses read Missile to Player Collisions. 


Not Used 

1 I I 1 

(zero forced) 

I D3 I D2 | D1 | DO 


3210 Player Number 

POPL, P1PL , P"PL, P3PL (Player to Player Collisions) (D00C , POOD , DOPE , 
POOF) : These addresses read Player to Player Collisions 


Not Used 

1 I 1 

1 

(zero forced) 

I D3 I D2 I D1 

I DO 


3210 Player Number 
(Player 0 against Player 0 is always a zero). Etc. 
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HITCLR (Collision "HIT” Clear) 


D01E 


This write address clears all collision bits described 
above. 


Not 

Used 


F. AUDIO 

AUDCTL (Audio Control) (D208) : This address writes data into the Audio 
Mode Control Register. (Also see SKCTL two-tone bit 3 and notes). 


D7 

! D6 

|D5 

D4 

1 D3 

D2 

L p,i 

DO 


D7 Change 17 bit poly into a 9 bit below poly. 

D6 Clock Channel 1 with 1.79 MHZ, instead of 64 KHZ. 

D5 Clock Channel 3 with 1.79 MHZ, instead of 64 KHZ. 

D4 Clock Channel 2 with Channel 1, instead of 64 KHZ (16 BIT). 

D3 Clock Channel 4 with Channel 3, instead of 64 KHZ (16 BIT). 

D2 Insert Hi Pass Filter in Channel 1, clocked by Channel 3. 
(See section II.) 

D1 Insert Hi Pass Filter in Channel 2, clocked by Channel 4. 

DO Change Normal 64 KHZ frequency, into 15 KHZ. 


Exact Frequencies : The frequencies given above are approximate. The 
Exact Frequency (fin) that clocks the divide by N counters is given below 
(NTSC only, PAL different). 


FIN 

(Approximate) 

FIN 

(Exact) 

1.79 MHZ 

1.78979 MHZ 

64 KHZ 

63.9210 KHZ 

15 KHZ 

15.6999 KHZ 


Use modified formula for fout 


Use normal formula for fout 


The Normal Formula for output frequency is: 


Fout « Fin/2N 

Where N = The binary number in the frequency register (AUDF) , plus 1 (N=AUDF+1). 
The MODIFIED FORMULA should be used when Fin = 1.79 MHZ and a more exact result 
is desired: 


Fout = Fin 

2 (AUDF + M) 

Where:. M = 4 if 8 bit counter (AUDCTL bit 3 or 4 = 0) 
M = 7 if 16 bit counter (AUDCTL bit 3 or 4 = 1) 
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AUDF1. AUDF2, AUDF3. AUDF4 (Audio Frequency) (D200, D202. D2Q4. D206) 
These addresses write data into each of the four Audio Frequency Control 
Registers. Each register controls a divide by "N" counter. 


D7 

! 

| D6 

1 

1 D5 

D4 

1 

1 D3 

1 

1 D2 

D1 

1 

1 DO 

"N" 

0 

0 

0 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

0 

0 

1 

2 




ETC. 





1 

1 

1 

1 

1 

1 

1 

1 

256 


Note: "N" is one greater 
than the binary number 
in Audio Frequency 
Register AUDF(X). 


AUDC1 , AUDC2, AUDC3. AUDC4 (Audio Channel Control) (D201 . D203. 

D205, D207): These addresses write data into each of the four Audio Control 
Registers. Each Register controls the noise content and volume of the 
corresponding Audio Channel. 


Noise Content or Distortion Volume 











Divisor "N" set 

HEX 

D7 

D6 

D5 

D4 

D3 

D2 

D1 

DO 

by audio frequency 

0 

0 

0 

0 

0 





register. 

- 17 BIT poly - 5 BIT 

2 

0 

0 

1 

0 





poly - N 

-5 BIT poly - N - 2 

4 

0 

1 

0 

0 





- 4 BIT poly - 5 BIT 

6 

0 

1 

1 

0 





poly - N 

- 5 BIT poly - N - 2 

8 

1 

0 

0 

0 





- 17 BIT poly - N 

A 

1 

X 

1 

0 





- Pure Tone - N - 2 

C 

1 

1 

0 

0 





- 4 BIT poly - N 

1 

X 

X 

X 

1 





- Force Output 
(Volume only) 

0 





0 

0 

0 

0 

- Lowest Volume (Off) 

8 





1 

0 

0 

0 

- Half Volume 

F 





1 

1 

1 

1 

- Highest Volume 
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PITCH VALUES FOR THE MUSICAL NOTES -AUDCTL =0, AUDC = hex AX 


HIGH 

NOTES 


MIDDLE C 


LOW 

NOTES 


AUDF 





Hex 

Dec 

c 



ID 

29 

B 



IF 

31 

A# 

or 

Bb 

21 

33 

A 



23 

35 

G# 

or 

Ab 

25 

37 

G 



28 

40 

F# 

or 

Gb 

2A 

42 

F 



2D 

45 

E 



2F 

47 

D# 

or 

Eb 

32 

50 

D 



35 

53 

C# 

or 

Db 

39 

57 

C 



3C 

60 

B 



40 

64 

A# 

or 

Bb 

44 

68 

A 



48 

72 

G# 

or 

Ab 

4C 

76 

G 



51 

81 

F# 

or 

Gb 

55 

85 

F 



5B 

91 

E 



60 

96 

D# 

or 

Eb 

66 

102 

D 



6C 

108 

C# 

or 

Db 

72 

114 

C 



79 

121 

B 



80 

128 

A# 

or 

Bb 

88 

136 

A 



90 

144 

G# 

or 

Ab 

99 

153 

G 



A2 

162 

F# 

or 

Gb 

AD 

173 

F 



B6 

182 

E 



Cl 

193 

D# 

or 

Eb 

CC 

204 

D 



D9 

217 

C# 

or 

Db 

E6 

230 

C 



F3 

243 


STIMER (Start Timer) (D209) : This write address resets all audio 
frequency dividers to their "AUDF" value. These dividers generate timer 
interrupts when they count down to zero (if enabled by IRQEN). (also see 
IRQST) 


not used 


RANDOM (Random Number Generator ) (D20A) : This address 
order 8 bits of a 17 bit polynomial counter (9 bit, if bit 


reads the high 
7 of AUDCTL=1 ) . 


D7 1 D6 1 D5 1 D4 1 D3 I D2 I D1 1 DO 
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KEYBOARD AND SPEAKER 


CONSOL (Console Switch Port) (D01F) : This address reads or writes data 
from the console switches and indicators. (Set to 8 by OS Vertical Blank 
code. ) 


Not Used 

1 1 1 

1 

(zero forced) 

1 D3 1 D2 I D1 

1 DO 


Hex 08 should be written to this address before reading the switches. 
Ones written will pull down on the switch line. 

CONSOL Bit Assignment: 


DO 

Game Start ^ 


Dl 

Game Select l 

- 0 means switch pressed. 

D2 

Option Select f 


D3 

Loudspeaker J 

- should be held at 1 


except when writing 0 
momentarily. OS writes a 
1 during vertical blank. 


KBCODE (Keyboard Code)(D209) : This address reads the Keyboard Code, 
and is usually read in response to a Keyboard Interrupt (IRQ and bits 6 or 7 
of IRQST). See IRQEN for information on enabling keyboard interrupts. See 
SKCTL bits 1 and 0 for key scan and debounce enable. 


D7 

1 

1 D6 

1 

1 25 

i 

[D4 

! 

1 D3 

i 

|D2 

1 

!D1 

i 

IDO 


D7 = Control Key 
D6 = Shift Key 

Read by OS into shadow CH when key is hit. The OS has a get character 
function which converts the keycode to ATASCII (Atari ASCII). 
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KEYCODE TO ATASCII CONVERSION 


KEY 

CODE 

KEY 

CAP 

■ 

U.C. 

CTRL 


KEY 

CODE 

KEY 

CAP 

m 

U.C. 

CTRL 

n 

L 

6C 

4C 

OC 


20 


2C 

5B 

00 

SB 

J 

6A 

4A 

OA 


21 

SPACE 

20 

20 

20 

mm 

9 

3B 

3A 

7B 


22 

• 

2E 

5D 

60 

is 






23 

N 

6E 

4E 

OE 

04 






24 





05 

K 

6B 

4B 

OB 


25 

M 

6D 

4D 

OD 

06 

+ 

2B 

5C 

IE 


26 

/ 

2F 

3F 


07 

* 

2A 

5E 

IF 


27 

A 

* 

* 

* 

08 

0 

6F 

4F 

OF 


28 

R 

72 

52 

12 

09 






29 





0A 

P 

70 

50 

10 


2A 

E 

65 

45 

05 

0B 

u 

75 

55 

15 


2B 

Y 

79 

59 

19 

OC 

RET 

9B 

9B 

9B 


2C 

TAB 

7F 

9F 

9E 

OD 

I 

69 

49 

09 


2D 

T 

74 

54 

14 

OE 

- 

2D 

5F 

1C 


2E 

W 

77 

57 

17 

OF 

= 

3D 

7C 

ID 


2F 

Q 

71 

51 

11 

10 

V 

76 

56 

16 


30 

9 

39 

28 


11 






31 





12 

c 

63 

43 

03 


32 

0 

30 

29 


13 






33 

7 

37 

27 


14 






34 

BACKS 

7E 

9C 

FE 

15 

B 

62 

42 

02 


35 

8 

38 

40 


16 

X 

78 

58 

18 


36 

< 

3C 

7D 

7D 

17 

Z 

7A 

5A 

1A 


37 

> 

3E 

9D 

FF 

18 

4 

34 

24 



38 

F 

66 

46 

06 

19 






39 

H 

68 

48 

08 

1A 

3 

33 

23 

* 


3A 

D 

64 

44 

04 

IB 

6 

36 

26 



3B 





1C 

ESC 

IB 

IB 

IB 


3C 

CAPS 

* 

* 

* 

ID 

5 

35 

25 



3D 

G 

67 

47 

07 

IE 

2 

32 

22 

FD 


3E 

S 

73 

53 

13 

IF 

1 

31 

21 

* 


3F 

A 

61 

41 

01 


* = special handling 
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H. SERIAL PORT (see peripheral connector on console) 


SKCTL (Serial Port control) (D20F) : This address writes data into the 
register that controls the configuation of the serial port, and also the 
Fast Pot Scan and Keyboard Enable. 

(Bits are normally zero 


1 

D7 1 D6 

1 

1 D5 

1 1 

1 D4 1 

1 1 1 
D3 1 D2 1 Dl 1 

1 DO 


and perform the functions 
shown below when true.) 

D7 

Force 

Break 

(force serial 

output 

to zero (space))* 


D6^ 

D5 ) Serial Port Mode Control (see mode chart at end of 
DbJ Serial port description, page 11.34). 


D3 Two Tone (Serial output transmitted as two tone signal instead of 
logic true/false.) 

D2 Fast Pot (Fast Pot Scan. The Pot Scan Counter completes its 
sequence in two TV line times instead of one frame time. The 
capacitor dump transistors are completely disabled.) 

D1 Enable Key Scan (Enables Keyboard Scanning circuit) 

DO Enable Debounce (Enables Keyboard Debounce circuits) 

DO-Dl (Both Zero) Initialize (State used for testing and initializing 
chip) ** 

OS SHADOW: SSKCTL (hex 232) 

The OS enables key scan and debounce and may change the other bits for 
different I/O operations. In particular, an aborted cassette operation may 
leave the two tone bit in the true state, causing undesirable audio signals. 
This may be corrected by writing hex 13 to both SKCTL and SSKCTL after doing 
I/O and/or before modifying the audio registers. 


* NOTE: When powered on, serial port output may stay low even if this bit 

is cleared. To get S.P. high (mark), send a byte out (recommend 
00 or FF). 

**N0TE: There is no original power on state. Pokey has no reset pin. 
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SKSTAT (Serial Port-Keyboard Status) (D20F) ; This address reads the 
status register giving information about the serial port and keyboard. 


(Bits are normally true 
and provide the following 
information when zero.) 

D7 = 0 = Serial Data Input Frame Error 


D7 I D6 1 D5 1 D4 I D3 1 D2 1 D1 1 DO 


D6 = 0 = Serial Data Input Over-run 

D5 = 0 = Keyboard Over-run 

D4 = 0 = Direct from Serial Input Port 

D3 = 0 = Shift Key Depressed 

D2 = 0 = Last Key is Still Depressed 


Latches 
must be 
reset = 1 
(SKRES) 

(D5 and D6 are set to 
zero when new data 
and same bit of IRQST 
is zero) 


D1 = 0 = Serial Input Shift Register Busy 


DO = 1 Not Used (Logic True) 


SKRES (Reset above Status Register ) (D20A) : This write address resets 
bits 7, 6, and 5 of the Serial Port-Keyboard Status Register to 1. 


not used 


SERIN (Serial Input Data)(D20D) : This address reads the 8 bit parallel 
holding register that is loaded when a full byte of serial input data has 
been received. This address is usually read in response to a serial data in 
interrupt (IRQ and bit 5 of IRQST). Also see IRQEN. 


D7 1 D6 I D5 I D4 I D3 I D2 I D1 I DO 


Serial I/O Port Connector Pinout: 



1. 

Clock In 

2. 

Clock Out 

3. 

Data In to computer 

4. 

GND 

5. 

Data Out of Computer 

6 . 

GND 

7. 

Command 

8. 

Motor Control 

9. 

Proceed 

10. 

+5 / Ready 

11. 

Audio In 

12. 

+12 

13. 

Interrupt 



See serial port description in OS 

manual 

for more detai 
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SEROUT (Serial Output Data)(D20D): This address writes to the 8 bit 
parallel holding register that is transferred to the output serial shift 
register when a full byte of serial output data has been transmitted. This 
address is usually written in response to a serial data out interrupt (IRQ 
and bit 4 of IRQST). 


D7 1 D6 | D5 1 D4 I D3 1 D2 I D1 1 DO 


I. CONTROLLER PORTS (front of console) 


PORTA (Port A)(D300) : This address reads or writes data from Player 0 
and Player 1 controller jacks if bit 2 of PACTL is true. This address 
writes to the direction control register if bit 2 of PACTL is zero. I/O for 
both ports (A and B) goes through a 6520/6820 


Data Register-Addressed if bit 2 of PACTL is 1. 


Joystick Operation 


1 

D7 1 D6 

1 

1 D5 

D4 | 

1 

D3 1 D2 

1 

D1 1 DO 

Right 

Back 


Right 

Back 

v Left 


Fwd. y 

v Left 

Fwd 


Stickl StickO 

(Jack 2) (Jack 1) 


0=Switch pressed 
l=Switch not pressed 


Paddle Operation 


D7 1 D6 I D5 1 D4 I D3 I D2 1 D1 I DO 


l— PTRIG2 
— PTRIG3 


L- PTRIGO 
PTRIG1 


0=Switch pressed 
l=Switch not pressed 


Keyboard Controller Operation 


D7 

1 

I D6 

1 

IDS 

1 

1 D4 

1 

1 D3 

1 

1 D2 

1 

1 HI 

1 

1 DO 


Top Row 
2nd Row 
3rd Row 
4th Row 


Top Row 
2nd Row 
3rd Row 
4rd Row 


Jack 2 


Jack 1 


Direction Control Register-Addressed if b it 2 of PBCTL is 0 

I I I I I I I 

D7 I D6 I D5 I D4 I D3 I D2 I D1 I DO 


Each bit corresponds to a jack pin 

0= input 
l=output 

OS SHADOWS: STICKO (hex 278), STICK1 (279), PTRIG0-3 (27C-27F 
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PACTL (Port A Control) (D302) : This address writes or reads data from 
the Port A Control Register. 


Port A Control 
Register 

Set up register as shown 
(X = described below) 

D7 - (Read only ) Peripheral A Interrupt Status Bit. Serial 
bus Proceed line. (Reset by reading Port A Register. 

Set by Peripheral A Interrupt.) 

D3 - Peripheral Motor Control line on serial bus (write) . 

(0 = On 1 = Off) 

D2 - Controls Port A addressing described above (write) . 

(1 = Port A Register 0 = Direction Control Register). 

DO - Peripheral A Interrupt Enable Bit. (Write) 1 = Enable. 
Reset by power turn-on or processor. Set by Processor. 


D7 | D6 | D5 1 D4 I D3 1 D2 1 D1 I DO 

X 0 1 I X X 0 X 


PORTB (Port B)(D301) : This address reads or writes data from Player 2 
and Player 3 controller jacks if bit 2 of PBCTL is true. This address 
writes to the direction control register if bit 2 of PBCTL is zero. I/O for 
both ports (A and B) goes through a 6520/6820. 

Data Register-Addressed if bit 2 of PBCTL is I 


Joystick Operation 


1 1 i 

1 1 

1 

1 

1 

0=Switch pressed 

D7 1 D6 | D5 | 

1 D4 1 D3 

1 D2 

1 01 1 

1 DO 

l=Switch not pressed 

Right Back 

Right 


Back 


^ Left 

Fwd 

Left 



Fwd 



Stick3 Stick2 

(Jack 4) (Jack 3) 


Paddle Operation 


1 1 ! 1 1 I 1 

D7 1 D6 I D5 I D4 1 D3 I D2 1 D1 1 DO 


1 — PTRIG6 
P TRIG 7 

1 — PTRIG4 
PTRIG5 


0=Switch pressed 
l=Switch not pressed 


Keyboard Controller Operation 


D7 1 D6 | D5 1 D4 I D3 I D2 I D1 1 DO 


Top Row^\ 
2nd Row l 
3rd Row / 
4th Row,/ 


Top Row 
2nd Row 
• 3rd Row 
4rd Row 


Jack 4 


Jack 3 
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Direction Control Register-Addressed if b it 2 of PBCTL is 0 


1 D7 1 D6 1 D5 1 D4 I D3 1 D2 I D1 1 DO 1 

Each bit corresponds to a jack pin 

0= input 
l=output 

OS SHADOWS: STICK2 (hex 21k), STICK3 (27B) , PTRIG4-7 (280-283) 


PBCTL (Port B Control) (D303) : This address writes or reads data from 
the Port B Control Register. 


Read Only 

I I I I I I I 

D7 I D6 I D5 I D4 I D3 1 D2 I D1 I DO 

xOllXXOX 


Port B Control 
Register 

Set up register as 
shown (X=Described 
below) 


D7 (Read only ) Peripheral B Interrupt Status Bit. Serial 
bus Interrupt line. Reset by Reading Port B Register. 
Set by Peripheral B Interrupt. 

D3 Peripheral Command Identification. Serial bus Command 
Line. 

D2 Controls Port B addressing described above. 

(1= Port B Register 0 = Direction Control Register) 

DO Peripheral B Interrupt Enable Bit. 1 = Enable. 

Reset by power turn-on or processor. Set by processor. 
(Set to hex 3C by OS IRQ code) 


POTO - P0T7 (Pot Values) (D200-D207) : These addresses read the value (0 
to 228) of 8 pots (paddle controllers) connected to the 8 lines pot port. 

The paddle controllers are numbered from left to right when facing the 
console keyboard. Turning the paddle knob clockwise results in decreasing 
pot values. The values are valid only after 228 TV lines following the 
"POTGO" command described below or after ALLPOT changes. 


I D7 1 D6 1 D5 1 D4 I D3 I D2 I D1 I DO 
Each Pot Value (0-228) 

OS SHADOWS: PADDLO - 7 (hex 270-277) 
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ALLPOT (All Pot Lines Simultaneously) (D208) : This address reads the 
present state of the 8 line pot port. 

Capacitor dump transitors must be turned off by either going to fast 
pot scan mode (bit 2 of SKCTL) or starting pot scan (POTGO). 


I D7 I D6 I D5 | D4 I D3 I D2 I D1 1 DO 1 

Pot number: 0 = Pot register value is valid. 

76543210 1= Pot register value is not valid. 

8 Pot Line States 


POTGO (Start Pot Scan)(D20B) : 


No 

Data Bits Used 


This write address starts the pot scan sequence. The pot values 
(POTO - P0T7) should be read first. This write strobe is then used causing 
the following sequence. 

1. Scan Counter cleared to zero. 

2. Capacitor dump transistors turned off. 

3. Scan Counter begins counting. 

4. Counter value captured in each of 8 registers (POTO - 
P0T7) as each pot line crosses trigger voltage. 

5. Counter reaches 228, capacitor dump transistors turned 
on. 


(Written to by OS vertical blank code) 


TRIGO, TRIG1 , TRIG2 , TRIG3 (Trigger Ports) (0 D010, 1 D011, 2 D012, 

3 D013) : These addresses read port pins normally connected to the joystick 

controller trigger buttons. 


0 = button pressed 

1 = button not pressed 


Not Used 

I 

(Zero Forced) 

1 DO 


OS SHADOWS: STRIG0-3 (hex 284-287) 


NOTE: TRIGO thru TRIG3 are normally read directly by the microprocessor. 

However, if bit 2 of GRACTL is 1, these inputs are latched whenever 
they go to logic zero. These latches are reset (true) when bit 2 
of GRACTL is set to 0. 
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PENH (Light Pen Horizontal Color Clock Position) (D40C) : This address 
reads the Horizontal Light Pen Register (based on the horizontal color clock 
counter in hardware). The values range from 0 to decimal 227. Wraparound 
occurs when the pen if near the right edge of a standard-width screen. PENH 
and PENV are modified when any of the joystick trigger lines is pulled low. 


1 

D7 1 D6 

1 1 1 1 1 

1 D5 1 D4 1 D3 1 D2 1 

Dl 

i 

1 DO 



H7 H6 

OS SHADOW: 

PENV 

H5 H4 H3 H2 HI HO 

LPENH (hex 234) 

(Light Pen Vertical TV Line Position) (D40D) : This 

address reads 

the Vertical Light Pen Register 

(8 

most significant bits, same as VCOUNT). 

1 

D7 I D6 

1 1 1 1 1 

1 D5 I D4 1 D3 1 D2 1 

Dl 

1 

1 DO 1 



LP8 7 

6 5 4 3 

2 

1 

0 LPO not read. 

Two line 


resolution supplied. 


OS SHADOW: LPENV (hex 235) 


Front Panel (Controller) Jacks as I/O Parts: 

PIA (6520/6820) 

Out: TTL levels, 1 load 
In : TTL levels, 1 load 


Port A Circuit (typical): 


6520 

(A) 

220 


Port 

\_L .ooi 


T 


Jack 


Port B Circuit 


(typical) : 
o+5 
4.7K 


6520 

(B) 

220 , 


Port 



T 


.001 


Jack 


"Trigger” Port Circuit (typical): 

220 


CTIA Trig 


^W\Aj 

■JLm ® 

T 


001 


Jack 
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Controller Port Pinout 


Male Female 

(console) (connector) 





Controllers 


HARDWARE 

OS 

PIN 

JOYSTICK 

PADDLE (POT) 

KEYBOARD 

REGISTERS 

VARIABLES 

1 

Forward 


Top Row* 

Bit 0 or 4** 

Bit 0*** 

2 

Back 


2nd Row* 

Bit 1 or 5** 

Bit 1*** 

3 

Left 

A(Lef t)Trigger 

3rd Row* 

Bit 2 or 6** 

PTRIGO, 2, 4, 6 
Bit 2*** 

4 

Right 

B (Right ) Trigger 

Bottom Row* 

Bit 3 or 7** 

PTRIG1 ,3,5,7 
Bit 3*** 

5 


POT B (Right) 

1st Column 

POT 1,3,5, 7 

PADDL 1 , 3 , 5 , 7 

6 

Trigger Button 


3rd Column 

TRIGO, 1,2,3 

STRIGO, 1,2,3 

7 


+5 

+5 



8 

GND 

GND 




9 


POTA (Left) 

2nd Column 

POT 0,2, 4, 6 

PADDLO, 2, 4, 6 


* 

Write 



** 

PORTA 

or 

PORTB 

■kick 

STICK 

o. 

1, 2 
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IV. SAMPLE PROGRAM 


This assembly language program illustrates the use of players, missiles, 
and display lists. The diagram on the next page shows what the display 
looks like and which objects are used. The comments in the program listing 
describe how it works. 


IV. 1 



CHECKERS DISPLAY 


M 

< 


TV LINES 
AFTER 
START OF 
DISPLAY 


Player/ 

Missiles 


Color Clocks- 
16 32 (decimal) 




168 192 

IZ6 | 



^-End of Vertical Blank 


24 Blank Lines 
20 Characters across by 
16 


8 Rows 

Vl6 Characters across by ] 


16 Characters across by £ 


38 - 


3C 


5C 


7C 




9C 


BC 


Player/Missile Horizontal Position 
Register Values (hex) • 


l lines high 

I t! If 


6 lines high 


lines high 




IV. 


u> 


0000 || 1 1 TLE "ATARI 800 CHECK! PS P1SPLHV HV f -HHW 2/31X80" 

20 -COPYRIGHT ATARI 1980 
40 ; 

50 ; THIS IS AN FXAMPLE OF R DISPLAY LIST WHICH USES CHRPHCT ER MAPPING TO 
60 - PRODUCE THE CHECKERS AND THE TOP AND BOTTOM BORDERS OF THE BOARD. 

70 ; PLAYERS ARE USED FOR THE RED SQUARES. THIS GIVES 6 COLORS WITHOUT 
60 ; CHANGING THE COLOR REGISTERS 

90 -MISSILES ARE USED FOP THE LEFT AND RIGHT BORDERS 
0100 -THE PROGRAM STARTS AT THE LOCATION SPECIFIED BY PMB 

0110 -A FEW TRICKS ARE USED TO SAVE PHM- BUT FURTHER OPTIMIZATION IS POSSIBLE 
0120 -THIS IS A RAM BASED PROGRAM WHICH RUNS WITH THE ASSEMBLER CARTRIDGE- NOT A 
0120 ; ROM CARTRIDGE 
0140 - 

0150 ; COLLEEN < ATARI 800) EQUATES 
0160 - 

D409 0170 CHBASE = *D409 

D400 0180 DMACTL = *D400 

022F 0190 SDMCTL = *022F 

D000 0200 HPOSP0 = *D000 

D008 0210 SIZEP0 = *D008 

02C0 0220 PCOLR0 * *02C0 

0220 0220 SDLSTL = *0220 

0231 0240 SDLSTH = *0221 

D01D 0250 GRRCTL = *D01D 

D407 0260 PMBASE = *D407 

026F 0270 GPRIOR = *026F 

0200 0280 VDSLST = *0200 

D40E 0290 NMIEN = *D40E 

0300 ; 

0310 ; DISPLAY LIST EQUATES 
0220 ; 

0080 0220 INT = *80 ; DISPLAY LIST INTERRUPT (BIT 7 OF NMI STATUS) 

0041 0340 JMPWT = *41 ; JUMP AND WAIT UNTIL END OF NEXT VERTICAL BLANK <3 BYTES) 

0049 0350 RELOAD = *40 ; RELOAD MEM SCAN COUNTER <3 BYTES) 

0020 0360 VSC = *20 ; VERTICAL SCROLL ENABLE 

0010 0270 HSC = *10 ; HORIZONTAL SCROLL ENABLE 

0001 0380 JUMP = 1 ; JUMP INSTRUCTION <3 BYTES) 

0000 0390 BLANK1 =0 ; 1 BLANK TV LINE 

0010 0400 BLANK2 = *10 ; 2 BLANK LINES 

0020 0410 BLANK3 = *20 ; 3 

0030 0420 BLANK 4 = *30 j 4 

0040 0430 BLANKS = *40 ; 5 

0050 0440 BLANKS = *50 - 6 

0060 0450 BLANK7 = *60 ; 7 

0070 0460 BLANK8 = *70 ;8 BLANK TV LINES 
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0000 

0470 


PAGE 



0480 

; 




0020 

0490 

INTOFF 

= 

<20 

; USED TO GET INTERNAL CODE FOR UPPER CASE ALPHANUMER I CS 


0500 






0510 

; INTERNAL 

CHARACTER CODES 


0520 

; 




0000 

0530 

SPI 

= 

" -INTOFF 


0021 

0540 

AI 

= 

'A- INTOFF 


0023 

0550 

Cl 

= 

"C- INTOFF 


0024 

0560 

DI 

= 

'D- 1 NT OFF 


0025 

0570 

El 


"E- INTOFF 


0027 

0580 

GI 


"G- INTOFF 


0028 

0590 

HI 

= 

"H- INTOFF 


0029 

0600 

II 

=» 

' I— INTOFF 


002F 

0610 

01 

= 

'0 - INTOFF 


0030 

0620 

PI 

S 

'P- INTOFF 


0032 

0630 

RI 

=* 

'R - INTOFF 


0034 

0640 

TI 


'T-INTOFF 


0039 

0650 

VI 


'V- INTOFF 


0011 

0660 

Nil 

= 

'1- INTOFF 


0013 

0670 

N8I 

= 

'8- INTOFF 


0019 

0680 

N9I 

= 

'9- INTOFF 


0010 

0690 

N0I 


'0- INTOFF 



0700 

i 





0710 

i CHECKERS 

EQUATES 



0720 

; 





0730 

; CODES 

FOR 

SPECIAL CHECKERS CHARACTER SET 


0740 

; 




0000 

0750 

EMPTV 

= 

0 

; EMPTV SQUARE 

0001 

0760 

CHECKER= 

1 

; ORDINARV CHECKER 

0002 

0770 

KING 

= 

2 


0003 

0780 

CURS 

= 

3 

; CURSOR (X) 

0004 

0790 

BORDER 

= 

4 

; USED FOR TOP AND BOTTOM BORDERS OF BOARD 


0800 

i 




0000 

0810 

CLP0 

= 

0 

; PLAVER 0 (HUMAN) 

0080 

0820 

CLP1 

= 

*80 

; PLAVER 1 (COMPUTER) 

00C0 

0830 

CLBOR 

= 

*C0 

; 80RDER COLOR (USED TO SET UP 2 MSB'S OF CHAR) 

5000 

0840 

PMB 

= 

*5000 

; PLAVER MISSILE BASE ADDRESS & PROGRAM LOCATION 
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0000 

0850 


PAGE 




0860 

; 






0370 

; PAH VARIABLES 




0880 






0000 

0890 


* = 

PMB 



5000 

0900 

BOfiRD 

** 

*■*■32 

i CHECKER BOARD (ONLY 22 BLACK 

SQUARES ARE USED> 

5020 

0910 

T0 


*+l 

; TEHP FOR MOVING BOARD TO MEM 

MAP 


0920 







0920 

; PLAYER AND 

HISSILE GRAPHICS 



0940 

; PLAYERS ARE 

USED FOR 

SQUARES/ MISSILES FOR LEFT AND 

RIGHT BORDERS 


0950 

; 





5021 

0960 


* = 

PMB+*180 



5180 

0970 

GRM03 


*+*80 

; MISSILE GRAPHICS 


5200 

0980 

GRP0 

*=S 

*+*80 

; PLAYER 0 GRAPHICS 


5280 

0990 

GRP1 

* = 

*+*80 

; PLAYER 1 


5300 

1000 

GRP2 


*+*80 

; 2 


5280 

1010 

GRP3 


*+*80 

; 3 



1020 

; 





5400 

1020 

TITL 

*= 

*+20 

;TOP LINE OF CHARS — ATASCII 

MESSAGE 

5414 

1040 

TOPBRD 


*+16 

/ TOP BORDER OF BOARD 


5424 

1050 

BRDSP 


8+16+* 

; BOARD DISPLAY 


54A4 

1060 

BGTBRD 

*=r 

*+16 

; BOTTOM BORDER 
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54B4 


1070 





1080 

; 




1090 

; GP 




1100 

i 


54B4 


1110 





1120 

GR 


5600 

00 

1130 



5601 

00 




5602 

00 




5603 

00 




5604 

00 




5605 

00 




5606 

00 




5607 

00 




5608 

2C 

1140 



5609 

7E 




560A 

FF 




560B 

FF 




560C 

FF 




560D 

FF 




560E 

7E 




560F 

2C 




5610 

3C 

1150 



5611 

7E 




5612 

A5 




5613 

A5 




5614 

C3 




5615 

C3 




5616 

7E 




5617 

3C 




5618 

C3 

1160 


1 — 1 

5619 

66 



< 

561A 

3C 



• 

561B 

18 




561C 

18 




56 ID 

3C 




561E 

66 




561F 

C3 




5620 

00 

1170 



5621 

FF 




5622 

FF 




5623 

FF 




5624 

FF 




5625 

FF 




5626 

FF 




5627 

00 




PAGE 

SPECIAL CHECKERS CHARACTER SET (ONLY CODES 0-4 ARE 
*= PMB+1608 

.BYTE 0, 0, 0, 0, 0, 0, 0, 0 ; BLANK <0> 


. BYTE *3C, *?E, *FF, *FF, *FF, *FF, *7E, *3C ; CHECKER <1> 


BYTE *3C, *7E, * A5> *A5, *C3, *C3, *7E, *3C ; KING <2> 


BYTE *C3, *66, *3C, *18, *18, *3C, *66, *C2 ; CURSOR <2> 


. BYTE 0, *FF, *FF, IFF, *FF, *FF, *FF, 0 ; BORDER <4> 


ISED;. 



IV. 
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5626 1180 PAGE 

1190 ; 

1200 . 

1210 i DISPLAY LIST 
1220 ; 

1230 DSP 


5628 

70 

1240 

. BYTE 

BLANK8 

; 24 BLANK LINES 

5629 

70 

1250 

. BYTE 

BLRNK8 


562A 

70 

1260 

. BYTE 

BLANK8 


562B 

46 

1270 

. BYTE 

RELOAD+6 

; LINES 0-7 MESSAGE LINE: 20 ACROSS X 5 COLOR X 1 LINE RESOLUTION CHARACTERS 

562C 

0054 

1280 

. WORD 

TITL 


562E 

80 

1290 

. BYTE 

I NT +BLANK1 ; 8. INTERRUPT TO CHANGE CHARACTER BASE ADDRESS AND CHANGE TO NARROW SCREEN 

562F 

06 

1300 

. BYTE 

6 

; 9-16 TOP BORDER: 16 X 5 X 1 CHARS <LAST LINE IS TOP OF 1ST ROW OF SQUARES) 

5630 

10 

1310 

1320 ; 

. BYTE 

BLANK2 

> 17-18 TOP OF FIRST ROW OF SQUARES 

CHECKERBOARD <8 LINES OF CHARS WITH SPACES INBET WEEN - 22 L I NES/SQUARE > 

5631 

07 

1330 

. BYTE 

7 

i 19-34. 16X5X2 LINE RESOLUTION CHARS 

5632 

50 

1340 

. BYTE 

BLANKS 

; 35-40. FIRST 3 LINES=BOTTOM OF FREVIOUS SQUARE. 

5633 

07 

1350 

. BYTE 

7 

; 41-56 

5634 

50 

1360 

. BYTE 

BLANKS 

; 57-62. LRST 3 LINES=TOP OF NEXT SQUARE. 

5635 

07 

1370 

. BYTE 

7 

; 63-78 

5636 

50 

1380 

. BYTE 

BLANKS 

; 79-84 

5637 

07 

1390 

. BYTE 

7 

; 85-100 

5638 

50 

1400 

. BYTE 

BLANKS 

; 101-106 

5639 

07 

1410 

. BYTE 

7 

; 107-122 

563A 

50 

1420 

. BYTE 

BLANKS 

; 123-128 

562B 

07 

1430 

. BYTE 

7 

; 129-144 

563C 

50 

1440 

. BYTE 

BLANK6 

; 145-150 

563D 

07 

1450 

. BYTE 

7 

; 151-166 

563E 

50 

1460 

. BYTE 

BLANKS 

; 167-172 

563F 

07 

1470 

1480 ; 

. BYTE 

7 

; 173-188 

NEXT THREE LINES ARE BOTTOM OF PREVIOUS SQUARE 

5640 

10 

1490 

. BYTE 

BLANK2 

; 189-190. END OF NORMAL DISPLAY < SHOULD BE ON SCREEN ON ALL TV'S). 

5641 

06 

1500 

. BYTE 

6 

; 191-198. BOTTOM BORDER <MAV OVERSCAN. BUT NOT ESSENTIAL TO GAME PLAY) 

5642 

41 

1510 

. BYTE 

JMPWT 

; WAIT FOR NEXT VBLRNK. THEN START OVER 

5643 

2856 

1520 

. WORD 

DSP 



1530 ; 

1540 ; 

1550 ; DSP — DISPLAY LIST INTERRUPT HANDLER. 

1560 ; CHANGES CHARACTER BASE AND WIDTH OF DISPLAY FOR SPECIAL CHECKERS GRAPHICS. 

1570 ; THE OS WILL CHANGE CHBRSE BACK TO NORMAL DURING VERTICAL BLANK. 

1580 ; 

1590 NCHR 

5645 48 1600 PHA 

5646 A956 1610 LDA #GR/256 

5648 8D09D4 1620 STA CHBASE 

1630 ; 

1640 ; INSTRUCTION FETCH DMA ENABLE. P/M 2 LINE RES. P/M DMA ENABLE. NARROW SCREEN <128 CLOCKS.) 


564B 

A92D 

1650 

LDA 

#*2D 

564D 

8D00D4 

1660 

STB 

DMACTL 

5650 

68 

1670 

PLA 


5651 

40 

1680 

RTI 
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I — I 
< 

00 


5652 1690 PAGE 

1700 ; 

1710 , INI T I ALIZAT I ON CODE — SI HPT EXECUTION HERE 
1720 ; 

5652 1730 *= PMB+1700 

1740 ; 

1750 ; I NIT OS'S DMACTL VARIABLE 

1760 ; INSTRUCTION FETCH DMA ENABLE, P/M 2 LINE RES, P/M DMA ENABLE, STANDARD SCREEN <160 CLOCKS) 
1770 ; 


5700 

A92E 

1780 

LDA 

#*2E 

5702 

8D2F02 

1790 

STA 

SDMCTL 



1800 > 





1810 ; CLEAR 

RAM 




1820 ; 



5705 

A900 

1830 

LDA 

#0 

5707 

AR 

1840 

TAX 




1850 INITLP 



5708 

9D0050 

1860 

STA 

PMB, X 

570B 

9D0051 

1870 

STA 

PMB+S100, X 

570E 

9D0052 

1880 

STA 

PMB+*200, X 

5711 

9D0053 

1890 

STA 

PMB+*300, X 

5714 

9D0054 

1900 

STB 

PMB+$400, X 

5717 

E8 

1910 

INX 


5718 

D0EE 

1920 

BNE 

INITLP 



1930 ; 




1940 ; INITIALIZE MISSILE GRAPHICS FOR BORDERS 
1950 ; 


571 A 

A90E 

I960 

LDA 

#*0E 

571C 

A05E 

1970 

LDV 

#*5E 

571E 

999451 

1980 LQPZ 

STA 

GRM03+S14, V 

5721 

88 

1990 

DEV 


5722 

D0FR 

2000 

BNE 

LQPZ 


2010 ; 

2020 ; INITIALIZE TOP AND BOTTOM BORDERS 
2030 ; 

5724 R010 2040 LDV #16 

5726 R9C4 2050 LDA #CLBOR+BORDER 

5728 991354 2060 TBLP STA TOPBRD-1, V 

572B 99R354 2070 STA BOTBRD-1, V 

572E 88 2080 DEV 

572F D0F7 2090 BNE TBLP ; CONTINUE UNTIL V=0 

2100 ; 

2110 ; INITIALIZE PLAYER GRAPHICS FOR SQUARES < CHECKER BOARD) V=0 
2120 ; 

5731 A9F0 2130 LDA #*F0 

5733 A20A 2140 IN2 LDX #10 

5735 991852 2150 IN3 STA GRP0+*18, V 

5738 999852 2160 STA GRP1+*18, V 

573B 991853 2170 STA GRP2+C18, V 

573E 999853 2180 STA GRP3+*18, V 

2190 i 



ATARI 800 CHECKERS DISPLAY BY C. SHRW 3/21/80 


5741 48 2200 PHA 

5742 A90A 2210 LDR #*0A 

5744 999851 2220 STR GRM03+*18, Y ; REST OF MISSILE QRRPHICS 

5747 68 2230 PLR 

5748 C8 2240 I NY 

5749 Cfl 2250 DEX 

574R 10E9 2260 BPL IN2 

574C 49FF 2270 EOR #*FF ; FILL IN OPPOSITE SQUARES 

574E C058 2280 CRY #33 

5750 90E1 2290 BCC IN2 

5752 A008 2300 LDY #3 

2310 ; 

2220 ; INITIALIZE PLAYER AND MISSILE POSITIONS AND COLORS 
2330 ; 

2 5754 B9D857 2340 IN4 LDR ITBL, V 

5757 9900D0 2350 STR HPOSP0, V 

v£> 575R 8fl 2360 TXA j *FF 

575B 9908D0 2370 STR SIZEP0, V ; *03 INDICATES 4 TIMES NORMAL SIZE <REST IS DON'T CARE) 

575E B9E057 2380 LDR ITBL1, V 

5761 99C002 2390 STR PCOLR0, Y 

5764 33 2400 DEV 

5765 10ED 2410 BPL IN4 

2420 ; 

2430 ;OS, ANTIC/ POKEY INITIALIZATION 
2440 ; 

5767 A928 2450 LDR #DSP&*FF /DISPLAY LIST START ADDRESS <LSB) 

5769 8D3002 2460 STA SDLSTL 

576C A956 2470 LDR #DSP/256 ; MSB OF ADDRESS 

576E 8D3102 2480 STR SDLSTH 

5771 A903 2490 LDR #3 ; ENABLE PLRVER/MISSILE DMA TO QRRPHICS REGS. 

5773 8D1DD0 2500 STR GRRCTL 

5776 A950 2510 LDR #PMB/256 /MSB OF ADDRESS OF PLAYER/MISSILE GRAPHICS 

5778 8D07D4 2520 STA PMBASE 

577B A914 2530 LDR #*14 j 5TH PLAYER ENABLE <USE PF3 FOR MISSILE COLOR)/ PF TAKES PR 10 OVER PLAYERS 

577D 8D6F02 2540 STA GPRIOR ; OS PRIORITY REG 

5730 R945 2550 LDR #NCHR.?,*FF ; DISPLAY LIST INTERRUPT VECTOR CLSB) 

5782 3D0002 2560 STA VDSLST 

5735 R956 2570 LDR #NCHR/256 

5737 8D0102 2530 STA VDSLST+1 

578A 8E0ED4 2590 STX NMIEN ; X=*FF *C0 ENABLES DISPLAY LIST & VBLANK INTERRUPTS. 

2600 ; 

2610 ; INI TIL I ZE BOARD DISPLAY 
2620 ; 


573D 

A20B 

2630 

2640 BRDLP 

LDX 

#11 



573F 

A901 

2650 

LDR 

#CHEO ER+CLP0 

/HUMAN PIECES ON 

SOUhPE^ 0—11 

5791 

9D0050 

2660 

STA 

BOARD, X 



5794 

A981 

2670 

LDA 

#CHECK ER+CLP1 

/COMPUTER PIECES 

ON SQUARES 20 

5796 

9D1450 

2680 

STA 

BOARD+20, X 



5799 

CA 

2690 

DEX 




579A 

10F3 

2700 

2710 ; 

BPL 

BRDLP 





IV. 10 


ATARI 800 CHECKERS DISPLHV BV C SHAW 3/21/e0 




2720 

; MOVE 

COPYRIGHT MESSAGE TO MESSAGE DISPLAY LINE 



2730 




579C 

R213 

2740 


LDX 

#19 

579E 

BDE957 

2750 

IN6 

L DA 

COPY, X 

57A1 

9D0054 

2760 


STA 

TITL, X 

57A4 

Cfl 

2770 


DEX 


57A5 

10F7 

2780 


BPL 

IN6 



2790 

; 





2800 

; LOOP 

70 MOVE BOARD TO GRAPHICS AREA. 



2810 

; THE 

CHECKERS PROGRAM LOGIC COULD BE ADDED HERE OR A VBLRNK INTERRUPT COULD BE USED. 



2820 

; 





2830 

LOOP 



57R7 

20HD57 

2840 


JSR 

UPCHR 

57RR 

4CR757 

2850 


JMP 

LOOP 



2860 

; 





2870 

; 





2880 

; 





2890 

; 





2900 

; UPCHR — SUBROUTINE TO MOVE 32 BVTES OF CHECKER BOARD TO DISPLRV RAM 



2910 

i 





2920 

UPCHR 



57AD 

R21F 

2930 


LDX 

#31 ; SQUARE 31 = UPPER LEFT 

57RF 

R000 

2940 


LDY 

#0 



2950 

UPLP1 



57B1 

R902 

2960 


LDA 

#4-1 ; 4 SQUARESXLINE 

57B3 

8D2050 

2970 


STA 

T0 



2980 

UPLP2 



57B6 

BD0050 

2990 


LDA 

BOARD, X 

57B9 

992654 

3000 


STA 

BRDSP+2, V ; FOR ROWS SHIFTED TO RIGHT 

57BC 

BDFC4F 

3010 


LDA 

BOARD-4, X 

57BF 

993454 

3020 


STA 

BRDSP+110, V ; FOR ROWS SHIFTED TO LEFT 

57C2 

C8 

3030 


I NY 


57C3 

C8 

3040 


I NY 


57C4 

C8 

3050 


I NY 


57C5 

C8 

3060 


I NY 


57C6 

CR 

3070 


DEX 


57C7 

CE2050 

3080 


DEC 

T0 

57CR 

10ER 

3090 


BPL 

UPLP2 



3100 

; 



57CC 

98 

3110 


TVR 


57CD 

18 

3120 


CLC 


57CE 

6910 

3130 


ADC 

#*10 

57D0 

R8 

3140 


TRY 


57D1 

8R 

3150 


TXA 


57D2 

E903 

3160 


SBC 

#4-1 ; CARRY IS CLEAR < SUBTRACT 4 > 

57D4 

HR 

3170 


TAX 


57D5 

B0DR 

3180 


BCS 

UPLP1 

57D7 

60 

3190 


RTS 




3200 

; 





3210 

i 





3220 

i 





3230 

i 
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ATARI 800 CHECKERS DISPLAY BY C 


;HAW 3/31/80 


57D8 3C 
57D9 5C 
57DR 7C 
57DB 9C 
57DC BC 
57DD 38 
57DE 38 
57DF 38 


57E0 34 
57E1 34 
57E2 34 
57E2 34 
57E4 36 
57E5 88 
57E6 0E 
57E7 26 
57E8 00 


0000 

0080 

0040 


57E9 00 
57EA 23 
57EB 2F 
57EC 30 
57ED 39 
57EE 32 
57EF 29 
57F0 27 
57F1 28 
57F2 34 
57F3 A1 
57F4 B4 
57F5 A1 
S7F6 B2 
57F7 A9 
57F8 51 
57F9 59 
57FA 58 
57FB 50 


3240 ; DATA 

3250 j HORIZONTAL POSITION OF PLAYERS (SQUARES) AND MISSILES (SIDE BORDERS >. 
3260 ; H0-F: I GHT BORDER. M1=I_EFT BORDER 
3270 ; M2 & M3 ARE PLACED WITH Ml. 

3280 ; P0, PI, P2, P3, M0, Ml, M2, M3 

3290 ITBL 

3300 . BYTE *3C, *5C, *7C, *9C, *BC, *38, *38, *38 


3310 ; 

3320 ; COLOR TABLE 
3330 ITBL1 

3340 . BYTE *34, *34, *34, *34 ; 4 PLAYERS (RED SQUARES > 


3350 . BYTE *36 ; PF0 : RED CHECKERS AND MESSAGES 

3360 . BYTE *88 ; PF1 : BLUE CHARACTERS 

3370 .BYTE *0E ; PF2 : WHITE CHECKERS AND MESSAGES 

3380 .BYTE *26 ; PF3 : YELLOW BORDER (CHARS & MISSILES) 

3390 . BYTE 0 > BK : BLACK BACKGROUND 

3400 ; 

3410 ; "COPYRIGHT ATARI 1980” MESSAGE 
3420 ; 

3430 OF = *00 i FOR PF0 COLOR (RED) 

3440 OF 2 = *80 i FOR PF2 COLOR (WHITE) 

3450 0F3 = *40 ; FOR PF1 COLOR (BLUE) 

3460 TGTBL 

3470 COPY . BYTE SPI, CI+OF, OI+OF, PI+OF, VI+OF, RI+OF, II+OF, GI+OF, HI+OF, TI+OF 


3480 


. BYTE AI+OF2, TI+0F2, AI+0F2, RI+0F2, II+0F2, N1I+OF3, N9I+0F3, N8I+0F3, N0I+OF3 




V 


HARDWARE REGISTER LISTS 


A. ADDRESS ORDER 


CTIA ADDRESSES 


Address 

WRITE 

READ 

Name I Description 

Name I Description 

DOFF 

a 

D020 


) REPEAT AS BELOW 

7 MORE TIMES 

D01F 

CONSOL 

Write Consol SW.Port 

CONSOL 

Read Consol SW. Port 

DOIE 

HITCLR 

Collision Clear 



DOID 

GRACTL 

Graphic Control 



DOIC 

VDELAY 




D91B 

PRIOR 

Priority Select 



DOIA 

COLBK 

Col-lum Bkgnd 



D019 

COLPF3 

Color-lum of 3 



D018 

COLPF2 




D017 

COLPF1 

Playfield 1 



D016 

COLPFO 

Playfield 0 



D015 

COLPM3 

Color-lum of 3 



D014 

COLPM2 

Player-Missile 2 

PAL 

READ PAL /NTSC bits 

D013 

COLPM1 

Player-Missile 1 

TRIG 3 

Read Joystick 

Trigger 

Buttons 

D012 

COLPMO 

Player-Missile 0 

TRIG2 

DOU 

GRAFM 

Graphics All Missiles 

TRIG1 

DOIO 

GRAFP3 

Graphics Player 3 

TRIGO 


GRAFP2 

Graphics Player 2 

P3PL 

Read Player 
to Player 

Collisions 

DOOE 

GRAFP1 

Graphics Player 1 

P2PL 


GRAFPO 

Graphics Player 0 

P1PL 

DOOC 

SIZEM 

Size All Missiles 

POPL 

DOOB 

SIZEP3 

Size Player 3 

M3PL 

Read Missile 

To Player 

Collisions 

DOOA 

SIZEP2 

Size Player 2 

M2PL 


SIZEP1 

Size Player 1 

M1PL 

D008 

SIZEPO 

Size Player 0 

MOPL 

D007 

HPOSM3 

Horz. Posit. Missile 3 

P3PF 

Read Player 

To Playfield 
Collisions 

D006 

HPOSM2 

Horz. Posit. Missile 2 

P2PF 

D005 

HPOSM1 

Horz. Posit. Missile 1 

P1PF 


HPOSMO 

Horz. Posit. Missile 0 

POPF 


HPOSP3 

Horz. Posit. Player 3 

M3PF 

Read Missile 

To Playfield 
Collisions 


HPOSP2 

Horz. Posit. Player 2 

M2PF 


HPOSP1 

Horz. Posit. Player 1 

M1PF 

D000 

HPOSPO 

Horz. Posit. Player 0 

MOPF 


V.l 

















































































































ANTIC ADDRESSES 


Address 

WRITE 

READ 

Name 1 Description 

Name 1 Description 

D4FF 

n 

v 

D410 

J REPEAT (AS BELOW) 

15 MORE TIMES 

D40F 

NMIRES 

Reset NMI 

Interrupt Status 

NMI Interrupt 

NMIST 

NMI Interrupt 

Status Register 

D40E 

NMIEN 

ENABLE 



D40D 



PENV 

Light Pen Register 
Vertical 

D40C 



PENH 

Light Pen Register 
Horizontal 

D40B 



VCOUNT 

Vertical Line 

Counter 

D40A 

WSYNC 

Wait for HBLANK 
Synchronism 



D409 

CHBASE 

Character Base 

Address Red 



D408 





D407 

PMBASE 

Player-Missile Base 
Address Register 



D406 





D405 

VSCROL 

Vertical Scroll 
Register 



D404 

HSCROL 

Horizontal Scroll 
Register 



D403 

DLISTH 

Display List 

Pointer (High Byte) 



D402 

DLISTL 

Display List 

Pointer (Low Byte) 



D401 

CHACTL 

Character Control 
Register 



D400 

DMACTL 

DMA Control 

Register 
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POKEY ADDRESSES 



WRITE 

READ 


1 Name 

j Description 

Name 

Description 

D2FF 



i 


i 

> REPEAT (AS BELOW) 

i 15 MORE TIMES 

i 

D210 





D20F 

SKCTLS 

Serial Port 4 Key 
Control 

SKSTAT 

Serial Port 4 Key 
Status Register 

D20E 

IROEN 

IRQ Interrupt 

Enable 

IROST 

IRQ Interrupt 

Status Register 

D20D 

SEROUT 



Serial Port 

Input Register 

D20C 





D20B 

POTGO 

Start Pot Scan 
Sequence 


Vertical Line 

D20A 

SKRES 

HHSH 

RANDOM 

Random Numb 
Generator 

D209 

STIMER 

Start Timers 

KBCODE 

Keyboard Code 

D208 

AUDCTL 

Audio Control 

ALLPOT 

Read 8 Line Pot 

Port State 

D207 

AUDC4 

Audio Channel 4 
Control 

POT 7 


D206 

AUDF4 

Audio Channel 4 
Frequency 

POT 6 


D205 

AUDC3 

Audio Channel 4 
Control 

POT 5 

Read the 

D204 

AUDF3 

Audio Channel 3 
Frequency 

POT 4 

value of 
each POT 

D203 

AUDC2 

Audio Channel 2 
Control 

POT 3 


D202 

AUDF2 

Audio Channel 2 
Frequency 

POT 2 


D201 

AUDC1 

Audio Channel 1 
Control 

POT 1 


D200 

AUDF1 

Audio Channel 1 
Frequency 

POT 0 
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PIA ADDRESSES 


Address 

WRITE 

READ 

Name 

Description 

Name 

Description 

D3FF 

D304 

Repeat £ 

is shown below many times 

> 


D303 

PBCTL 

PORT B CONTROL 

PBCTL 

Same as write 

D302 

PACTL 

PORT A CONTROL 

PACTL 

Same as write 

D301 

PORTB 

Direction Register 

If PBCTL Bit 2-0 
(otherwise) 

PORTB 

Same as write 

PORTB 

Jack 2 & Jack 3 

If Direction Bits 

Are 1 * 

PORTB 

Jack 2 & Jack 3 

If Direction Bits 
Are 0 * 

D300 

PORTA 

Direction Register 

If PACTL Bit 2=0 
(Otherwise) 

PORTA 

Same as write 

PORTA 

Jack 0 & Jack 1 

If Direction Bits 

Are 1 * 

PORTA 

Jack 0 & Jack 1 

If Direction Bits 
Are 0 * 


* NOTE: Output data is retained in Jack Output Registers. 

If direction bits are true, a read of the jacks 
will read old data from these registers. 




































B 


ALPHABETICAL ORDER 


Hardware Register 

OS Shadow 



Address 


Address 

Name 

Description 

I Hex 

1 Dec 

Name 

Hex 

Dec 

ALLPOT 

Read 8 line Pot Port State 






AUDC1 

Audio Channel 1 Control 


mm 




AUDC2 

Audio Channel 2 Control 

D203 

53763 




AUDC3 

Audio Channel 3 Control 

D205 

53765 




AUDC4 

Audio Channel 4 Control 

D207 

53767 




AUDCTL 

Audio Control 

TF 

53768 




AUDF1 

Audio Channel 1 Frequency 


53760 




AUDF2 

Audio Channel 2 Frequency 

D202 

53762 




AUDF3 

Audio Channel 3 Frequency 

D204 

53764 




AUDF4 

Audio Channel 4 Frequency 

D206 

53766 




CHACTL 

Character Control 

■ 

54273 

CHART 

2F3 

755 

CHBASE 

Character base address 

EK9 

54281 

CHBAS 

2F4 

756 

COLBK 

Color-Luminance of Background 

D01A 

53274 

COLOR 4 

2C8 

712 

COLPFO 

Color Luminance of Playfield 0 

D016 

53270 

COLORO 

2C4 

708 

COLPF1 

Color Luminance of Playfield 1 

D017 

53271 

COLOR 1 

2C5 

709 

COLPF2 

Color Luminance of Playfield 2 


53272 

COLOR 2 

2C6 

710 

COLPF3 

Color Luminance of Playfield 3 

DO 19. 

53273 

C0L0R3 

2C7 

711 

COLPMO 

Color Luminance of Player-Missile 0 

D012 

53266 

PCOLRO 

2C0 

704 

COLPM1 

Color Luminance of Player-Missile 1 

D013 

53267 

PC0LR1 

2C1 

705 

COLPM2 

Color Luminance of Player-Missile 2 

D014 

53268 

PC0LR2 

2C2 

706 

COLPM3 

Color Luminance of Player-Missile 3 

D015 

53269 

PC0LR3 

2C3 

707 

CONSOL 

Console Switch Port 

D01F 

53279 

Set to 

8 during VBLANK 

DLISTH 

Display List Pointer (high byte) 

D403 

54275 

SDLSTH 

231 

561 

DLISTL 

Display List Pointer (low byte) 

D402 

54274 

SDL STL 

230 

560 

DMACTL 

Direct Memory Access (DMA) Control 

D400 

54272 

SDMCTL 

22F 

559 

GRACTL 

Graphic Control 

D01D 

53277 




GRAFM 

Graphics for all Missiles 


53265 




GRAFPO 

Graphics for Player 0 

KB 

53261 




GRAFP1 

Graphics for Player 1 

1 

53262 




GRAFP2 

Graphics for Player 2 


53263 




GRAFP3 

Graphics for Player 3 

D010 

53264 




HITCLR 

Colission Clear 

D01E 

53278 




HPOSMO 

Horizontal Position of Missile 0 

D004 

53252 




HPOSM1 

Horizontal Position of Missile 1 

D005 

53253 




HPOSM2 

Horizontal Position of Missile 2 

D006 

53254 




HPOSM3 

Horizontal Position of Missile 3 


53255 




HPOSPO 

Horizontal Position of Player 0 

DOOO 

53248 




HPOSP1 

Horizontal Position of Player 1 

D001 

53249 




HPOSP2 

Horizontal Position of Player 2 


53250 




HPOSP3 

Horizontal Position of Player 3 

3 SB 

53251 




HSCROL 

Horizontal Scroll 

D404 

54276 




IRQEN 

Interrupt Request (IRQ) Enable 

D20E 

53774 

POKMSK 

10 

16 

IRQST 

IRQ Status 

D20E 

53774 




KBCODE 

Keyboard Code 

D209 

53769 

CH 

2FC 

764 

MOPF 

Missile 0 to Playfield Collisions 

DOOO 

53248 





Missile 0 to Player Collisions 


53256 




M1PF 

Missile 1 to Playfield Collisions 

i min ■Bis 

53249 




M1PL 

Missile 1 to Player Collisions 


53257 




■ 

Missile 2 to Playfield Collisions 

riltllKMi 

53250 





Missile 2 to Player Collisions 

DOOA 

53258 
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Hardware Register 

! OS Shadow 



Address 


Address 

Name 

Description 

Hex 

Dec 

Name 

Hex 

Dec 

EK 

Missile 3 to Playfield Collisions 

D003 

53251 




mSa 

Missile 3 to Player 

DOOB 

53259 




NMIEN 

Non-Maskable Interrupt (NMI) Enable 

D40E 

54286 

Set to $40 by IRQ code 

NMIRES 

NMI reset 

D40F 

54287 

written to by NMI code 

NMIST 

NMI Status 

D40F 

54287 

read by NMI code 


POPF 

Player 0 to Playfield Collisions 







Player 0 to Player Collisions 






P1PF 

Player 1 to Playfield Collisions 


53253 




P1PL 

Player 1 to Player Collisions 


53261 




P2PF 

Player 2 to Playfield Collisions 

D006 

53254 




P2PL 

Player 2 to Player Collisions 

DOOE 

53262 




P3PF 

Player 3 to Playfield Collisions 

D007 

53255 




P3PL 

Player 3 to Player Collisions 

DOOF 

53263 




PACTL 

Port A Control 

D302 

54018 

Set to $3C by IRQ Code 

PAL 

PAL /NTSC indictor 

D014 

53268 






PBCTL 

Port B Control 



Set to $3C by IRQ Code 

PENH 

Light Pen Horizontal Position 


54284 

LPENH 

234 

564 

PENV 

Light Pen Vertical Position 

D40D 

54285 

LPENV 

235 

565 

PMBASE 

Player Missile Base Address 

D407 

54279 




PORTA 

Port A 

D300 

54016 

STICK0.1 

278.279 

632,633 

PORTB 

Port A 

D301 


STICK2, 3 

27A, 27B 

634,635 

POTO 

Pot 0 

D200 

E ! 

PADDL0 

270, 

624 

POT1 

Pot 1 

D201 

S 

PADDL1 

271 

625 

POT2 

Pot 2 

D202 

E Iffl 

PADDL2 

272 

626 

POT3 

Pot 3 

D203 

53763 

PADDL3 

273 

627 

POT4 

Pot 4 

D204 

53764 

PADDL4 

274 

628 

POT5 

Pot 5 

D205 

mm 

PADDL5 

275 

629 

POT 6 

Pot 6 

D206 

mm 

PADDL6 

276 

630 

POT 7 

Pot 7 (right paddle controller) 

D207 

53767 

PADDL7 

277 

631 

POTGO 

Start POT Scan Sequence 

D20B 

53771 

WRITTEN DURING VBLANK 

PRIOR 

Priority Select 

D01B 

53275 

GPRIOR 

26F 

623 

RANDOM 

Random number generator 

D20A 

53770 




SERIN 

Serial Port Input 

D20E 

53774 




SEROUT 

Serial Port output 

D20D 

53773 




SIZEM 

Sizes for all missiles 

DOOC 

53260 




SIZEPO 

Size of Player 0 

D008 

53256 




SIZEP1 

Size of Player 1 

D009 

53257 




SIZEP2 

Size of Player 2 

DOOA 

53258 




SIZEP3 

Size of Player 3 

DOOB 

53259 




SKCTL 

Serial Port Control 

D20F 

53775 

S SKCTL 

232 

562 

SKREST 

Reset Serial Port Status (SKSTAT) 

D20A 

53770 




SKSTAT 

Serial Port Status 

D20F 

53775 




S TIMER 

Start Timer 

D209 

53769 




TRIGO 

Joystick Controller Trigger 0 

D010 

53264 

STRIG0 

284 

644 

TRIG1 

Joystick Controller Trigger 1 

D011 

53265 

STRIGL 

285 

645 

TRIG2 

Joystick Controller Trigger 2 

mm 

53266 

STRIG2 

286 

646 

TRIG3T 

Joystick Controller Trigger 3 

B39 

53267 

STRIG3 

287 

647 

VCOUNT 

Vertical Line Counter 

D40B 

54283 




VDELAY 

Verical Delay 

DOIC 

54276 




VSCROL 

Vertical Scroll 

D405 

54277 




WSYNC 

Wait for Horizontal Sync 

D40A 

54282 

Used by keyboard 






click routine 



V. 6 






























































VI. FIGURES 


A. MEMORY MAP 


ADDRESS 

FUNCTION 

SIZE 

FFFF 

Operating System 



And 

10K 


Math Routines 


D800 



D000-D7FF 

Hardware Addresses 

2K 

CFFF 

Reserved for Future 

O.S. expansion 

4K 

BFFF 

ROM Cartridge 



(Colleen left and right 
slot and Candy single 
slot all address to 

16K 

8000 

this space) 


7FFF 

RAM 



Expansion * 


2000 



1FFF 

RAM initially 
supplied in the 
product 

8K 


RAM expansion can actually exten to BFFF. However, the ROM cartridges 
will deselect the RAM. Deselection occurs on 8K boundaries. Atari 400 
units are RAM expandable only at the factory. They can accept RAM up 
to 2FFF (16K) when fully extended. 
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VERTICAL (SCAN LINE) COUNTER 


277 , -v 

274 | 137 1 SET VSYNCX 


9- 


127 


1 28 


247 


246 


274 


gi— 

£_H 


63 


64 


123 


124 


137 


275 


137 


RESET VSYNC 


/! 


RESET 
VCTR 
RESET- 
VBLANK 
( START 
DISPLAY) 


CENTER 

OF 

SCREEN 

iu 

z 

_l 

(M 

F 

Z 

3 

O 

O 

> 

SET 

VBLANK 

SET 

VSYNC 


«u 

is; 

UjUj 

aii) 


PAL VERTICAL 
" DISPLAY ' 


a 

ia 

.of 

Lg 

So 

ftO 


a 

nii- 
m* 1 
QQ 

<< 

ill a 6 feiii 


a . \ 
o £ 
cQZ^ 

Of 3a 

qi Q 

O |_ H 

n wa 

°fn.< 


LL 

0 

flz 

mm 

Lui 

ztt 

iuQ 

0(0 


U 


Q 

Z 


Q 

z 

D 


U. 

8 


NARROW PLAYFIELD 
123 COLOR CLOCKS 


STANDARD PLAVFIELD 
ISO COLOR CLOCKS 


a 

&z 

to 

00 


&70 

nil 

m 

9!uti 

U1U>10 

111 


Q 

Z 

I 


-«■ 


WIDE PLAVFIELD 
I7G COLOR CLOCKS DISPLAYED 
(1 32 COLOR CLOCKS READ) 


r-SET VSYNC 
RESET VSYNC 
RESET VCTR 

253 

251 -.250 
254 
261 


PRESET 
VBLANK 
(START 
DISPLAY) 


CENTER 
*— OF 

SCREEN 




$ — 
fO 

v9 

s & 

?3 

L0Z 

261 


HORIZONTAL POSITION REGISTER VALUES 


NTSC AND PAL HORIZONTAL DISPLAY 


fi 

m 


>--sgT 

v VBLANK 
Y- SET 
° VSYNC 




125 


126 


f=*= 


4 - 7 

4 ...a 

a 

4 

127 . 

63 

128 

64 

250 


247 

Ixiratd 

123 


•27 

130 


125 


248 


251 


124 


125 


NTSC 

VERTICAL 

DISPLAY- 


VC0UNT- 2 LINE RESOLUTION 





CPU BOA RD 
(SOCKET) 


MASTER 


KEYBOARD 



J IOT 


MOTHER BOARD 
ATARI 400 
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TEST CPU 

POINTS 0110 






































































TO CONTROL SWITOCS 






(FROM 

POWER 

A D APT E R ) 


INTERLOCK 

SWITCH 


POWER 

SWITCH 


POWER SUPPLY BOARD 
ATARI 400 




L C 

FI LTE R 


TO TELEVISON 


TO PERIPHERAL JACK 



J 201 


J 20 2 


(TO MOTHER BOARD) 




400 POWER SUPPLY 


C202 

CR202 470 





(FROM 

POWER 

ADAPTER ) 




-5 

GND 

+12 

i 

+ 5A 

! 

+5B 

MOO 


RESET 

OPTION 

SELECT 

GAME 

SELECT 

GAME 

START 


C202 

470 



800 POWER SUPPLY 


POWER IN 


7 

2 

12 

9 

II 

7 

lO 

5- 

9 

3 

I, —————— g 

I 4 • 

5 

In £ 

ii 


IC2II 

I 10 


I GND 

4 5 B/READV 
+ 12 

INTERRUPT 
I CLOCK OUT — ► 
{ PROCEED 
COMMANO 

OATA OUT ► 

DATA IN 

CLOCK IN ■+ 

MOTOR CONTROL 
AUDIO IN ■+ 


NOTE: 

I. UNLESS OTHERWISE SPECIFIEO 

(A) ALL CAPACITORS ARE IN>iF 

(B) ALL RESISTORS ARE IN OHMS, I/4W, 8% 


J-C2I6 

T -OOI 


I S20 4 

0 ' 

I S209 

LTT_H 

■° ,s?osi 

1 ~1 
-O 


c=^ 7 

o 




COMP CHROMA 
AUOIO OUT — ► 
COMP VIDEO 
COMP LUM 
GNO 


•1209 




TO MOTHER BOARD 


AnnRFSs nns 



CHIP SELECTS 



PERSONALITY BOARD 
ATARI 80 0 





A 4 0 2 ROM 
CO i 2399 















TO MOTHER BOARD 



CPU BOARD 































TO MOTHE 



8 K DYNAMIC RAM 

ATARI 








8K RAM 

















DATA BUS 


DATA OUT 


TR I- 

STATE 

BUFFER 



16 K DYNAMIC RAM 

ATA R I 













o 
i r 
< 
o 

CD 




SCHEMATIC Rom CARTRIDGE 



































APPENDIX A 


USE OF PLAYER/MISSILE GRAPHICS 
WITH BASIC 


The ATARI ® 400/800 ^ Hardware Manual should be read first to understand 
the details of the Player/Missile Graphics. 

To enable the P/M Graphics from BASIC the following procedure 
can be used:* 

1. Generate the playfield, either with a GRAPHICS call or build 
a custom display list with a series of POKE statements. 

2. Enable P/M DMA control by a POKE 559 with either a 62 for 
single line resolution players or a 46 for double line 
resolution players. 

3. There are four players and four missiles {or five players if 
the four missiles are combined into one player). Each of 
these has a horizontal position register that controls its 
horizontal position on the screen. The registers and their 
locations are as follows: 


ADDRESS 


HORIZONTAL POSITION OF 


53248 

53249 

53250 

53251 

53252 

53253 

53254 

53255 


Player 0 
Player 1 
Player 2 
Player 3 
Missile 1 
Missile 2 
Missile 3 
Missile 4 


The horizontal positions can range on the playfield between 41 
and 200. So POKE 53249,120 will move Player 1 to the middle 
of the screen. 


*NOTE: All number references are decimal. 
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Use of Player/Missile Graphics 
with BASIC, cont. 


4. Each player (and its missile) has a color register which 

determines its color. These registers can be controlled by 
poking to the following locations: 


ADDRESS 

COLOR 

OF 

704 

P/M 0 


705 

P/M 1 


706 

P/M 2 


707 

P/M 3 


711 

fifth 

player (if enabled) 


Thus a POKE 706,200 will color player 2 green. 

5. The P/M bit information (those bytes which actually describe 
the shape of the player) must be stored in an area where it 
will not interfere with BASIC or the operating system. It 
must also start at a 2K memory boundary if single line 
resolution players are used, or a IK boundary for double line 
resolution players. 

6. The page number (i.e. number of 256 byte sections of memory) 
for the starting address of the P/M information obtained in 
step 5 is poked into location 54279. 

7. Enable the P/M DMA by a POKE 53277,3. 

8. The starting address of each player is obtained by multiplying 
the number obtained in step 6 by 256 and then adding the 
offset indicated in P/M memory configuration table. 

9. The vertical position of the player is determined by its 
location in memory. After the initial offset is obtained in 
step 8, its height may be defined. Its range on the playfield 
is from 32 to 223 in single line resolution and from 16 to 111 
in double line resolution. By adding the desired height to 
the initial offset, the absolute address of each player is 
found. The appropriate bit information for the player can now 
be poked into this address. 
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Use of Player/Missile Graphics 
with BASIC, cont. 


( 9 , cont . ) 

Example to Generate a rectangular box player, eight color 
clocks wide and four lines high in immediate mode. 


STEP 

TYPE 

RESULT 

1 

GRAPHICS 8 

Setup Mode 8 Play field 

2 

POKE 559, 62 

Enable P/M DMA single line 

3 

POKE 53248,120 

Set horizontal position 

4 

POKE 704,88 

Set color to pink 

5 

I = PEEK (106) -8 

Get P/M base address 

6 

POKE 54279,1 

Store in base register 

7 

POKE 53277,3 

Enable P/M DMA 

8 

J = I * 256 + 1024 

Get player starting address 

9 

POKE J + 125,255 

POKE J + 126,129 

POKE J + 127,129 

POKE J + 128,255 

Draw player on screen 
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1024 bytes 


Use of Player/Missile Graphics 
with BASIC, cont. 


t 


+ 


DMACTL 
bit D4=0 


DMACTL 
bit D4=l 


start at 
PMBASE*JL004O5b 


start at . 

PMBASE * ^046*^5 (* 


+0 


+0 


+384 

+512 

+640 

+768 

+896 

+1024 


**-- 8 bits wide 

384 bytes 
unused 

— 8 bits wide -■* 

768 bytes 
unused 

M3 M2 Ml M0 

Player 0 

Player 1 

Player 2 

M3 

M2 

Ml 

M0 

Player 3 

128 bytes 
per player 

V. ^ 

Player 0 

\S 

double line 
resolution 

Player 1 

Player 2 


Player 3 


+768 


+1024 


+1280 


+1536 


+1792 


+2048 


PLAYER-MISSILE 

Memory 

Configuration 


Absolute address 
\ determined by 
i PMBASE. 

i 

i 

| Relative address 
i shown along sides 
i of maps. 

i 

i 

{ Each Player-Missile 
i section (128 bytes 
| in single line, 256 
i bytes in double line) 
i maps directly onto 
| the total height of 
m TV screen. 

CD 

+j 

co 

O 

CN 


256 bytes 
per player 




single line 
resolution 
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APPENDIX B 


MIXING GRAPHICS MODES 


I. GENERAL 


This procedure describes how to mix several graphic modes on 
the TV screen at the same time using BASIC commands. Each graphics 
mode has a different number of scan lines per "Mode Line” (one line 
of a graphics mode). The TV screen must consist of 192 scan lines, 
so when mixing modes, they must be combined in* such a way as to get 
192 scan lines. This is accomplished by modifying the Display 
List. 


When a graphics mode is set on the computer, the 0/S allocates 
RAM space for the graphics mode, then builds the, display list 
adjacent to the graphics RAM, and sets a pointer to the beginning 
of the display list. Each "mode line" is constructed from a "mode 
byte" in the display list that determines how many scan lines in 
each mode line. The display list describes the screen display from 
top to bottom. 

A Display List must be built for the "max RAM mode" (the 
graphics mode that requires the most RAM) then modified with POKES 
to mix the other modes with it. This "max RAM mode" cannot be a 
split screen mode (text window), therefore "max RAM mode" +16 must 
be used. If the max RAM mode will be at the top of the screen, then 
the "LMS byte" (load memory scan byte) at the top of the Display 
List will already be correct. If not, the "LMS byte" will have 
to be modified. 

The Display List is modified by POKING a new mode byte for 
each mode line that is not a max RAM mode line. At the end of the 
display list is a JUMP instruction pointing to the top of the 
Display list. When the Display List is modified, the JUMP instruc- 
tion must be placed immediately after the last mode byte. 

Example #1 will be used throughout this procedure to 
illustrate each step. 
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Mixing Graphics Modes, cont 


1 I , PROCEDURE TO SET UP SCREEN IN MIXED MODES : 

1. Select modes desired, then look up which mode is the max 
RAM mode from table #2. 

example: modes selected - mode 1, mode 7, mode 2 

mode 7 “ max RAM mode 

2. Use table #1 to calculate the number of mode lines such 
that the total number of scan lines = 192. 

examp 1 e : | I s c an | 

I j 1 ines | 

j //mode | per | scan 

mode | line i mode | lines 



192 TOTAL 


3. If the max RAM mode is at the top of the screen, then skip 

this step: Calculate the LMS byte by setting the left 

nibble to 4, then use table #1 to find the right nibble for 
the graphics mode at the top of the screen. 

example: 1. left nibble = 4 

2. right nibble for mode 1=6 

3. LMS byte = 46 (HEX) 

4. Calculate the mode byte for each mode. Set the left nibble 
to 0, use table //I to find the right nibble for each mode. 

example: I Left | Right | Mode 

Mode) Nibble] Nibblej Byte 
I I I (HEX) 
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Mixing Graphics Modes, cont 


II. PROCEDURE TO SET UP SCREEN IN MIXED MODES , cont.: 


5. Convert all bytes to decimal. 


example: Byte 1 (HEX) | DEC 

LMS | 46 1 70 

Mode 1 1 06 1 6 

Mode 7 I 0D 1 13 

Mode 21 07 1 7 


6. Execute a graphics call on the computer using the max RAM 
mode (+16). 


example: GRAPHICS 7+16 

7. PEEK the Display List pointer and use it to calculate a 
variable labelled "START”. 

example: START = PEEK(560) + PEEK(561) * 256 + 4 

8. If the max RAM mode is at the top of the screen, then skip 

this step: Poke the LMS byte to location START-1. 

example: POKE START-1,70 


9. Every mode line requires a mode byte in the Display List in 
the same order as the mode lines appear on the screen. The 
mode bytes must be POKED into the Display List at location 
START + offset, where offset = mode line //. 


Example: MODE LINE // 


POKE INSTRUCTION 


2 

3 

MODE 1 4 

5 

6 


POKE START + 2,6 
POKE START + 3,6 
POKE START + 4,6 
POKE START + 5,6 
POKE START + 6,6 


MODE 7 


see note for mode 7 (max RAM mode) 


MODE 2 63 

64 


POKE START + 63,7 
POKE START + 64,7 


NOTE: The Display List will already be correct for the max RAM 
mode, therefore its mode bytes do not need to be POKEd. 
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Mixing Graphics Modes, cont 


II. PROCEDURE TO SET UP SCREEN IN MIXED MODES « cont.: 

10. POKE the JUMP instruction followed by the LO byte, then the 
HI byte into the Display List. The offset for the JUMP 
POKE is the last mode line # + 1, for LO byte it is + 2, 
for HI byte it is 4- 3. 

example: (last mode line # was 64) 

REMARK POKE INSTRUCTION 

JUMP POKE START + 65,65 

LO BYTE POKE START + 66, PEEK(560) 

HI BYTE POKE START + 67, PEEK(561) 


III. PROCEDURE TO PRINT AND PLOT IN MIXED MODES 


1. If the mode line # ' s of a mode on the screen fall within 
the range of that mode's normal mode line #'s then use the 
following procedure: 

a. POKE 87 with the mode // 

b. Determine the Y coordinate by counting the # of mode 
lines from the top of the screen to the current 
position. 

c. Determine the X position in the normal manner for that 
mode . 

d. Depending on the mode, either PLOT and DRAWTO , or 
POSITION and PRINT. 

e. These steps must be done for each mode on the screen 
that meets the condition in step 1. 

example: MODE 1 POKE 87,1 

POSITION 2,1: PRINT # 6 ; "TEXT " 

MODE 7 POKE 87,7 

COLOR 1 : PLOT 20,20:DRAWTO 30,30 

MODE 2 See step 2 
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Mixing Graphics Modes, cont. 

III. PROCEDURE TO PRINT AND PLOT IN MIXED MODES , cont. 

2. Some modes may have mode line # ' s outside of their normal 
range . 

example: Mode 2 normally has mode line #' s 1 through 12 

(full screen). These are modified to #63 and 
#64 in example #1. 

To prevent the computer from giving a "cursor out of range" 
error message the following procedure can be used: 

a. Set a variable labelled "MEMST" to be the display 
memory start pointer. 

MEMST = PEEK ( START ) + PEEK ( START + 1) * 256 

b. Set a variable labelled CHRP OS to position characters 
to be printed on the target line. 

CHRPOS = MEMST + [ (Mi - 1 ) *R-M 2 * (R-2 0 ) -M 3 * (R- 1 0 ) ] +X 

Where : 

X = horizontal position of character on the target 
line. 

R = the RAM per line of the Max RAM Mode (table #1). 
Mj = the Mode Line # of the target line. 

M 2 = the number of mode lines of 20 bytes of RAM per 
line above the target line. 

M 3 = the number of mode lines of 10 bytes of RAM per 
line above the target line. 

Example: calculate CHRPOS for Mode Line #64 (the 

last line of the Mode 2 area) at horizontal 
position 5. 

X = 5 

R =40 
Mj =64 

M 2 = 7 (6 from Mode 1 area, 1 from Mode 2 area). 

m 3 = 0 

CHRPOS = MEMST + [ ( 6 4- 1 ) * 4 0 - 7 * ( 4 0 - 2 0 ) - 0 * ( 4 0 - 1 0 ) ] +5 
CHRPOS = MEMST + [ ( 6 3 ) * 4 0 - 7 * ( 2 0 ) - 0 * ( 3 0 ) ] +5 

CHRPOS = MEMST + [2520 - 140] + 5 

CHRPOS = MEMST 4- [2380] + 5 

CHRPOS = MEMST + 2385 
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Mixing Graphics Modes, cont. 

III. PROCEDURE TO PRINT AND PLOT IN MIXED MODES , cont. 

2 . cont. 

c. If few characters will be printed, then each character's 
internal value may be looked up in the Internal 
Character Set Table (Table 9.6), in the new BASIC 
Reference Manual. This value is then POKED into 
CHRPOS. 

d. If strings are to be output, and if the ATASCII values 
of all the characters lie within one of the ranges 
shown in the table below, then do the following: 

1) Obtain the appropriate ATASCII value range for 
the characters 

2) Do the OPERATION the table indicates on the 
ATASCII value of each character. 

3) POKE this value into CHRPOS. 


ATASCII VALUE 
RANGE 

1 

! OPERATION 

0-31 

1 

| Value 

+ 64 

32-95 

i Value 

- 32 

96-127 

| NONE 


128-159 

1 Value 

+ 6 4 

160-223 

j Value 

- 32 

224-255 

| NONE 



Example: 1) assume we want to print the word ’ , TEXT ,, 
in the mode 2 area of example #1 using 
the CHRPOS calculated previously. 

2) these characters are in the ATASCII 
VALUE RANGE of "32 - 95". 

3) the OPERATION for this range is "Value-32", 
so 32 must be subtracted from each 
ATASCII value. 

4) the program statements would now look 
like this: 

T $ ( 1 , 4 ) = "TEXT" 

CHRPOS = MEMST + 2385 


FOR X = 1 TO LEN (T $ ) 

POKE CHRPOS + X - 1, ASC [T$(X,X) ] - 32 

NEXT X 

(OPERATION: value - 32) 



5) the FOR/NEXT loop POKES the first 
character of T$, AS C [ T $ ( X , X) ] -3 2 , into 
CHRPOS + 0. 

6) the next iteration POKEs the next 
character of T$ into the next CHRPOS, 
and so on . 
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Mixing Graphics Modes, cont. 

TABLE #1 


MODE BYTE 


1 

1 

REMARK | 

1 

. I 

LEFT 

NIBBLE 

(HEX) 

1 1 

1 1 

1 1 
! 1 

1 1 

hi 

RIGHT 

NIBBLE 

(HEX) 

c . c . 

PER 

PIXEL 

SCAN | 
LINES 1 
PER | 
MODE j 
LINE I 

# 

COLORS 

1 

1 

| MODE 
1 

J 

1 

1 RAM 

I PER 
j LINE 

1 

CD ! 


1 L 

2 

% 

8 | 

1 k 


I 40 

4 

| CHAR J_ 

3 

h 

10 1 

n 


| - 

I 40 

L 


1 L 

4 

l 

8 I 

4 


j - 

I 40 



! MODES J_ 

. 5 _ 

l 

16 | 

4 


j - 

I 40 

0 

1 1_ 

6 

l 

8 I 

5 


1 1 

I 20 

1 


i ! 

7 

l 

16 1 

5 


1 2 

1 20 

! 


1 J_ 

8 

4 

8 1 

4 


1 3 

I 10 

© i 


1 L 

9 

2 

4 1 

2 


1 4 

1 10 

4 

] graphic_L 

A 

2 

4 i 

4 


1 5 

1 20 

_ . 1 


1 J_ 

B 

1 

2 ! 

2 


I 6 

i 20 

1 


| MODES _L 

C 

1 

1 I 

2 


1 — 

! 20 



! _L 

D 

1 

2 1 

4 


! 7 

1 40 

© i 

0 

1 JL 

E 

1 

1 j 

4 



1 40 


1 I 

F 

k 

1 1 

Ik 


1 8 

1 40 

BLANK 1 

0-7 

© i 

0 

BLANK 


- 


| 

| 

JUMP | 

4 

1 special 1 

1 

JUMP 

| 

- 


| 

| - 


© 

© 

© 

© 


When the max RAM mode is not at the top of the screen, the 
left nibble of the LMS byte must be changed to a 4. 


Left nibble for all mode bytes after the LMS byte. 


Color & Lum for the field is controlled by Setcolor 2, and 
Lum for charactors or graphics from Setcolor 1. 


JUMP - used to end the display list and return to the 
beginning . 


BLANK - to output selected number of background lines. 
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Mixing Graphics Modes 

, cont. 



TABLE #2 



GRAPHICS MODES 



RAM REQUIREMENTS 


Mode 8+16 

8138 

By t es 

8 

8112 


7 + 16 

4200 


7 

4190 


6 + 16 

2184 


6 

2174 


5 + 16 

1 176 


5 

1174 


4 + 16 

696 


4 

694 


3+16 

432 


3 

434 


2+16 

420 


2 

424 


1 + 16 

672 


1 

674 


0 

992 


These values include the display list 

and any imbedded 

unused memory blocks. 
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Decreasing 32 byte s dl 

RAM 


MEMORY CONFIGURATIONS 
FOR MODES 0 - 4 


34 bytes DL 


32 bytes DL 


54 bytes DL 56 bytes DL 


960 

bytes 

character 

map 


400 

bytes 

character 

map 


480 

bytes 

character 

map 


80 bytes 
unused 


160 bytes 
text 

window 



80 bytes 
unused 


160 bytes 
text 

window 
























MEMORY CONFIGURATIONS 
FOR MODES 5-8 


RAM 

Bytes 


8192 


Decreasing 

RAM 


6144- 


4096 


2048- 


Top Of 
Free 
RAM 


94 bytes DL 104 bytes DL 


54 bytes DL ~v 56 bytes DL 


800 bytes 
bit map 


160 unused 


160 text 


960 bytes 
bit map 


160 unused 


1600 

bytes 

bit 

map 


320 unused 


160 text 


1920 

bytes 

bit 

map 


160 unused 


94 bytes DL— ^ 104 bytes DL-^ 


96 unused 


3200 

bytes 

bit 

map 


640 bytes 
unused 


160 text 


96 unused 


3840 

bytes 

bit 

map 


160 unused 


176 bytes DL — ^ 202 bytes DL 


80 unused 


6400 

bytes 

bit 

map 


1280 

bytes 

unused 

16 unused — 


1 60 text 


80 unused 




7680 

bytes 

bit 

map 


16 unused - 


160 unused 


MODE: 


5 + 16 


6 + 16 


7+16 


8 + 16 



APPENDIX C: PINOUTS 



1 . Clock Input 

2. Clock Output 

3 . Data Input 

4. Ground 

5 . Data Output 

6 . Ground 

7 . Command 


8 . Motor Control 

9 . Proceed 

10. +5/Ready 

11. Audio Input 

12. +12 volts 

13. Interrupt 


Controller Jack 



1 . 

(Joystick) 

Forward Input 

6 . 

Trigger Input 

2 . 

(Joystick) 

Back Input 

7 . 

+5 volts 

3. 

(Joystick) 

Left Input 

8 . 

Ground 

4. 

5. 

(Joystick) Right Input 

B Potentiometer Input 

9. 

A Potentiometer Input 
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